Skip to content

Latest commit

 

History

History
56 lines (37 loc) · 5.49 KB

README.md

File metadata and controls

56 lines (37 loc) · 5.49 KB

Warzone PublicMaps

Warzone Logo

This repository contains public maps and active rotations that are found on Warzone. These maps are designed to be compatible with the PvP Game Manager (PGM) plugin and Minecraft 1.8.9. Non-commercial maps or maps used under the explicit permission of their author(s) are hosted at PrivateMaps. For changes, updates, or any other modification intended for privately-hosted maps, please contact a Map Developer on Warzone.


Contributing

When creating a new map or modifying an existing map, please note some of the requirements for our maps. Pull requests from non-map developers that affect the map rotation are subject to approval and may be closed.

To start contributing, you must clone this repository online, GitHub Client (recommended for most users), alternative GUI clients, or Git CLI (for advanced users) with the command, git clone https://github.com/Warzone/PublicMaps.git.

World Version

  • Every map must work with Minecraft 1.8.9. To determine the version of a map, you can open the map's level.dat with an NBT editor and find the value of Data/DataVersion or Version.
  • If the world version is from a future (1.9.x and above) or from past (1.7.x and below) versions of Minecraft, you must convert the map to be compatible with 1.8.9.

Chunk Pruning

In order to remove undesired portions of the map as well as to decrease its total file size, the map needs to be pruned before it can be accepted into the repository.

  • This means that all chunks, excluding the map itself, should be deleted from the world.
  • This can be achieved with third-party programs such as MCASelector, MCEdit-Unified, or MCEdit 2.0.
  • After pruning the map, please make sure that you only include the required world files (region/*, level.dat, map.png, map.xml).

XML Creation

  • All maps must include a valid map.xml to function properly with PGM. The map protocol must be 1.4.2 (older maps are exempt from this requirement).
  • The map version must follow the Semantic Versioning standard.
    • For example, all new maps will begin at version 1.0.0. You must increase the version number accordingly with any updates toward that map.
  • Refer to Additional Resources on following proper XML format.

Support

If you need any additional support with the mapmaking process, you may visit the #mapmaking channel in the Warzone Discord server.

Additional Resources

  • PGM Documentation - The most current documentation for the latest (1.8) version of PGM. It covers the various features and modules offered by PGM as well as XML syntax. This resource is useful for beginner mapmakers that are not sure where to begin.
  • Visual Studio Code, Sublime Text, or Notepad++ - Some of the recommended programs for editing XML files, as it comes with syntax highlighting, autocompletion, and other tools to help you create XML files for your maps.
  • webNBT or NBT Explorer - This website will allow you to edit a Minecraft world's level.dat file, which lets you have a control over specific settings not normally present in-game. It can also let you determine what Minecraft version a map was created for.

License

Maps in this repository are made available under the CC BY-SA 4.0 license, which allows you to share and adapt any maps of this repository, even for commercial purposes, as long you give appropriate credit and provide your modifications under the same license. By submitting a map for use at Warzone, you agree with the terms of the aforementioned license, and must distribute your map with it where applicable.

Acknowledgements

This repository represents the combined efforts of several contributors, map makers, and map developers since the original release of PGM in 2012 and TGM in 2017. Without them, this repository and Warzone would not exist. Additionally, we'd like to credit the following:

  • MCResourcePile - for their hard work compiling and archiving hundreds of maps from several communities, making them available for public download and use.
  • Overcast Community's PublicMaps - for their continued efforts in maintaining and updating commercial map files, making them available for everyone.