Cartographer

This is the code that powered the map config creator/editor tool of the former Minespree Network.

Besides the removal of some branding and configuration data, it is more or less unmodified. It is probably not directly useful to third parties in its current state, but it may be help in understanding how the Minespree network operated.

We are quite open to the idea of evolving this into something more generally useful. If you would like to contribute to this effort, talk to us in Discord.

Please note that this project might have legacy code that was planned to be refactored and as so, we kindly ask you not to judge the programming skills of the author(s) based on this single codebase.

Requirements

To build Cartographer, the following will need to be installed and available from your shell:

• JDK 8 version 131 or later (older versions might work)
• Git
• Maven

You can find detailed installation instructions for these tools on the Getting started docs page.

Getting started

You can build this project running the following command:

mvn package

Please note that you might also want to mvn install this module to your local .m2 repo as it is required by most Bukkit plugins. You can also deploy it to your own Maven repo to use the GitLab CI Docker image and make distribution easier. Instructions

Next, move the produced artifact on target/ to your Spigot (test) server plugins/ directory and restart the instance.

Finally, run one of the map creation commands to start the process of creating a new map. You can check the Docs for more information about this process.

This project also includes a GitLab CI .gitlab-ci.yml build config file to automatically build and deploy our artifacts to the main and development networks. This process requires the use of a custom Docker image, but its setup is documented on the Docs page.

Architecture

This repo contains the following components:

• Map creation wizard
• BlockWars map schema
• Clash map schema
• Double Trouble map schema
• SkyWars map schema
• Thimble map schema

Authors

This project was maintained by the Minespree Game team. If you have any questions or problems, feel free to reach out to the specific writers and maintainers of this project:

Doshy

yoop

Coding Conventions

• We generally follow the Sun/Oracle coding standards.
• No tabs; use 4 spaces instead
• No trailing whitespaces
• No CRLF line endings, LF only, put your git's core.autocrlf on true.
• No 80 column limit or 'weird' midstatement newlines.

License

Cartographer is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

A copy of the GNU Affero General Public License is included in the file LICENSE, and can also be found at https://www.gnu.org/licenses/agpl-3.0.en.html

The AGPL license is quite restrictive, please make sure you understand it. If you run a modified version of this software as a network service, anyone who can use that service must also have access to the modified source code.