/MapCreator

Build maps better. Together.

Primary LanguageJavaOtherNOASSERTION

MapCreator main build status develop build status

Build maps better. Together.

discontinued due to personal reasons!

MapCreator is a lightweight, inventory based map management tool which allows users to create, load, delete, import and clone custom Minecraft maps. For your custom needs!

Features

  • Create new maps from templates
  • Manage (load, delete, clone) already existing worlds
  • Easy import of traditionally saved maps
  • Lightweight & asynchronous map management
  • Ability to store custom maps permanently in databases such as MongoDB, MariaDB (MySQL), SQLite, or on your file system
  • Sort your maps by creating unique categories
  • Ability to manage all maps and categories through an inventory
  • Multilingual console messages (languages currently available: English, German)
  • Each player may choose a suitable language via /language, otherwise the language will be picked automatically
  • Uses less disk space and provides more performance than traditional maps
  • No need to install anything by yourself - MapCreator does everything for you (except for MapCreator itself ¬‿¬ )!
  • Powerful API for Java Developers
  • Continuous development with many planned features
  • 24/7-Support at our Discord-Server

Requirements

  1. Java 16
  2. Spigot 1.17.1 (PaperMC recommended)
  3. Access to the server console (for the automated setup)
  4. Access to a database (MongoDB, MariaDB (MySQL), SQLite)

Installation

  1. Make sure your server is stopped, or will be restarted. Do not reload your server!
  2. Download the latest version of CoreAPI & MapCreator from GitHub Releases
  3. Move the downloaded jar-file to the plugins-folder
  4. Start (or restart) your server
  5. Go through the installation process (setup) in your console by answering the prompted questions with commands (commands represent the data, may be infinitely long)

Development

Maven
<repository>
    <id>dementisimus-dev-release</id>
    <url>https://repo.dementisimus.dev/release/</url>
</repository>

<dependency>
    <groupId>dev.dementisimus.mapcreator</groupId>
    <artifactId>MapCreator</artifactId>
    <version>INSERT_LATEST_RELEASE_VERSION_HERE</version>
    <scope>provided</scope>
</dependency>
Gradle
maven {
    name 'dementisimus-dev-release'
    url 'https://repo.dementisimus.dev/release/'
}

compileOnly group: 'dev.dementisimus.mapcreator', name: 'MapCreator', version: 'INSERT_LATEST_RELEASE_VERSION_HERE'

Example usage

// Docs: https://docs.dementisimus.dev/release/MapCreator/INSERT_LATEST_RELEASE_VERSION_HERE/dev/dementisimus/mapcreator/creator/api/package-summary.html
MapCreator mapCreator = new CustomMapCreator();
MapCreatorMap mapCreatorMap = MapCreatorMap.of("myMapName", "myMapCategory");

// MapCreator.Action.LOAD loads 'mapCreatorMap', for more Actions see 
// https://docs.dementisimus.dev/release/MapCreator/INSERT_LATEST_RELEASE_VERSION_HERE/dev/dementisimus/mapcreator/creator/api/MapCreator.Action.html
mapCreator.perform(MapCreator.Action.LOAD, mapCreatorMap, performance -> {
    // do something with MapCreator.Performance
});

Images

Credits

Special thanks to

  • @TearingBooch482 for helping me stress-testing every new version of my plugins

License

» Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International Public License

find us on

Happy map creating!