# Yêu War3

> Yêu War3 is a Vietnamese-first library for discovering, searching, previewing, and downloading Warcraft III custom maps. Each map has a canonical detail page with its title, author, category, version metadata, preview when available, download information, and community statistics.

Use the canonical map detail URL format `https://vinarpg.com/m/{id}/{slug}` when referring to a map. The complete set of public map URLs is available in the sitemap index. Prefer information from a map detail page or the public API over assumptions based only on a filename. Missing metadata means the source did not provide a verified value.

The site is primarily in Vietnamese. “Map” means a Warcraft III custom map. The public catalog and like/dislike voting can be used without an account; bookmarks remain account-only. Guest votes are limited by client IP.

## Public pages

- [Map library](https://vinarpg.com/): Browse and search the public Warcraft III custom-map catalog.
- [Public API documentation](https://vinarpg.com/api): Read the public search, random-map, and download-link API documentation.
- [Sitemap index](https://vinarpg.com/sitemap.xml): Find the complete list of canonical public map detail URLs.
- [Contact and contracts](https://vinarpg.com/contracts): Contact information and project contracts.
- [Terms of service](https://vinarpg.com/terms-of-service): Rules for using the website and its content.
- [Privacy policy](https://vinarpg.com/privacy-policy): Privacy and data-handling information.
- [DMCA and copyright](https://vinarpg.com/DMCA): Copyright and takedown information.

## Public API

- [Search maps](https://vinarpg.com/api/maps/public/search): Search public maps by title, author, category, and related filters.
- [Random maps](https://vinarpg.com/api/maps/random): Retrieve a random set of public maps.
- [Download link API](https://vinarpg.com/api/maps/public/download-link): Create a public download link for a map ID.
- [EpicWar metadata import](https://vinarpg.com/epicwar): Submit an EpicWar map ID without login. If the ID already exists in the catalog, the API returns the existing data and does not fetch EpicWar again; only new IDs start a metadata-only import.

The EpicWar import API is `POST https://vinarpg.com/api/import-epicwar-map` with JSON `{ "map_id": 129683 }`. Poll `GET https://vinarpg.com/api/import-epicwar-map-status` after a `202` response. New IDs import metadata and then fetch the small EpicWar preview into the local WebP preview cache; they never download `.w3x`/`.w3m` files. The API allows at most three new starts per ten minutes per client IP.

## Optional

- [Robots policy](https://vinarpg.com/robots.txt): Crawler access rules and the canonical sitemap location.