# MapManager-Core<\/p>\n
MapManager-Core is a simple and easy-to-use Minecraft server plugin that offers efficient and flexible multi-world management capabilities.<\/p>\n
## Installing MapManager<\/p>\n
Make sure you have LuckPerms and Multiverse-core installed before installation<\/p>\n
1. **Download the Plugin**
\n2. **Install the Plugin**: Place the downloaded `MapManager-Core-{version}.jar` file into the `plugins` directory of your server.
\n3. **Start the Server**: If the server is running, it needs to be restarted to load the plugin. If the server is not started, simply start the server.<\/p>\n
## Map Permission Groups<\/p>\n
Map permissions are divided into three categories: `admin`, `builder`, `visitor`.<\/p>\n
– **admin**
\n – Map administrators, who can add or remove members from private maps, manage physical (block updates), explosion protection, public status, name, and spawn point of the map.
\n– **builder**
\n – Builders, who can build on private maps. The permissions available to builders are configured in `worldbase`.
\n– **visitor**
\n – Visitors, who can enter private maps but do not have building permissions.<\/p>\n
## Configuring Permission Groups<\/p>\n
MapManager-Core automatically creates two permission groups upon first load: `worldbase` and `apply`. Here is a guide on how to configure these two permission groups:<\/p>\n
### worldbase Permission Group<\/p>\n
The `worldbase` permission group provides necessary permissions for the builders (builder group) in the map. These permissions are automatically inherited by the corresponding map’s permission group upon creation.<\/p>\n
We recommend adding building permissions for the map to builders (e.g., essentials.build, buildcore.protect.*), WorldEdit permissions, etc.<\/p>\n
### apply Permission Group<\/p>\n
The `apply` permission group provides server-wide permissions for players with private map permissions. The permission group created at the time of map creation will inherit `apply`.<\/p>\n
You can configure permissions for the public material library or the map hosting players as members, etc., for the `apply` permission group.<\/p>\n
This step is optional.<\/p>\n
1. **Adding Permissions**: Similar to the commands above, you only need to add the respective permission nodes to the apply group.<\/p>\n
## Configuration File<\/p>\n
MapManager’s configuration file `MapManagerConfig.yml` offers some global settings options:<\/p>\n
“`yaml
\n!MapManagerConfig #Configuration file marker, do not modify
\nglobal:
\n exploded: null # Whether to globally enable explosion damage. Options: true, false, null
\n physical: null # Whether to globally enable physical effects. Options: true, false, null
\n“`<\/p>\n
exploded: Controls whether explosion damage effects are allowed. A null value indicates adherence to each world’s settings.
\nphysical: Controls whether physical effects (such as block dropping) are allowed. A null value indicates adherence to each world’s settings.<\/p>\n
## Commands<\/p>\n
Here are all commands which MapManager registered.<\/p>\n
* \/world admins<\/p>\n
List all admins in a world.<\/p>\n
* \/world admin Add an admin to or remove an admin from a world.<\/p>\n * \/world builders<\/p>\n List all builders in a world.<\/p>\n * \/world builder Add a builder to or remove a builder from a world.<\/p>\n * \/world visitors<\/p>\n List all visitors in a world.<\/p>\n * \/world visitor Add a visitor to or remove a visitor from a world.<\/p>\n Tip: Fill the * \/world physics [info|true|false]<\/p>\n * info or null – Show whether the physics turned on in the world. * \/world explosion [info|true|false]<\/p>\n * info or null – Show whether the world has explosion. * \/world pvp [info|true|false]<\/p>\n * info or null – Show whether the world can pvp. * \/world kick Kick a player out of your world.<\/p>\n * \/world setname Set the name of the world.<\/p>\n * \/world setspawn<\/p>\n Set the spawn location.<\/p>\n * \/world reload<\/p>\n Permission “mapmanager.administrator” is required.<\/p>\n Reload the config.<\/p>\n * \/import n: Permission “mapmanager.command.import” is required.<\/p>\n Import and initialize a world.<\/p>\n * \/delete [world]<\/p>\n Permission “mapmanager.command.delete” is required.<\/p>\n Delete a world.<\/p>\n * \/write<\/p>\n Permission “worldmanager.command.write” is required.<\/p>\n Print details of all worlds.<\/p>\n ## Development<\/p>\n ### Dependencies<\/p>\n Maven<\/p>\n “`xml Gradle (kotlin)<\/p>\n “`kts ### JavaDoc<\/p>\n JavaDoc Documentatiton<\/p>\n","protected":false},"excerpt":{"rendered":" Simple, easy, use LuckPerms to complete multi-world permission management<\/p>\n","protected":false},"featured_media":98296,"template":"","meta":{"_minecraft_slug":"mapmanager-core","_minecraft_project_id":"4UQ1TZII","_minecraft_author":"Hanamizu","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":761,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mapmanager-core.zip","_minecraft_size_bytes":30030743,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T09:22:07.180733Z","_minecraft_date_created":"2024-09-07T18:42:15.936070Z","_minecraft_date_modified":"2024-11-23T12:27:07.010264Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mapmanager-core","_minecraft_icon_attachment_id":98296,"_minecraft_imported_at":"2026-06-05T15:26:51+00:00","_minecraft_import_hash":"9f7e4663bf884cdd7a04f598883ac7c1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,159],"mod_loader":[132],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74],"class_list":["post-98295","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-worldgen","mod_loader-paper","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3"],"yoast_head":"\n
\n * true – Turn on the physics
\n * false – Turn off the physics<\/p>\n
\n * true – Turn on the explosion.
\n * false – Turn off the explosion.<\/p>\n
\n * true – Turn on the pvp.
\n * false – Turn off the pvp.<\/p>\n
\n
\n
\n
\n <\/repository>
\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\nmaven(url = “https:\/\/oss.sonatype.org\/content\/groups\/public\/”)
\ncompileOnly(“work.alsace.mapmanager:MapManager-Core:3.0”)
\n“`<\/p>\n
\n### How to Integrate MapManager-Core
\n“`java
\nMapManager mapManagerCore = ((MapManager) Objects
\n .requireNonNull(Bukkit.getServer()
\n .getPluginManager()
\n .getPlugin(“MapManager-Core”));
\n“`<\/p>\n