> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticdarkzone/frequently-asked-questions-faq.md).

# Frequently Asked Questions (FAQ)

Answers to common ManticDarkzone setup questions.

## Where should I begin?

ManticDarkzone supports Minecraft versions from 1.8 through the latest version and is distributed as a ready-to-install jar. Install that jar and the compatible ManticLib release for your ManticDarkzone version in the server's `plugins` folder, then restart. Purchase the plugin and download its jar and available updates from the [ManticDarkzone product page](https://www.mantic.dev/product/manticdarkzone) and your purchase downloads. Start the server once to generate the files. Claim your license key using the instructions provided with your purchase, put it in the `license` setting in `plugins/ManticDarkzone/config.yml`, then restart the server. Keep the key private. After that, use `/mdz zones` to create a spawn zone in game.

See the [setup and configuration guide](https://docs.mantic.dev/manticdarkzone) and the [configuration file list](https://docs.mantic.dev/manticdarkzone/config-files).

## Why are no mobs spawning?

Check all of these:

* `enabled: true` in `darkzone-mobs.yml`.
* The zone has the exact loaded `world-name`, a non-empty list of available mobs, and `max-mobs` above 0.
* At least one player is in the zone's world and its chunks are loaded.
* The bounds include solid ground and enough empty space above it. An all-zero example zone covers only one position.
* The global `spawn-frequency-seconds` is at least 1.

If the server log reports a YAML error, restore the generated file from a backup and reapply the change carefully. Use spaces for YAML indentation, not tabs.

## Why does the zone not include the area I expected?

The two corners form a rectangular three-dimensional volume. Use `/mdz zones` in game to select and preview them; you do not need to edit `zones.yml` by hand. Check X, Y, and Z in both corners, include the height mobs need to stand, and use the exact loaded world name.

## Why did a bound mob stop outside its zone?

Bound mobs need a walkable route to their individual return point. Walls, cliffs, unloaded chunks, and unsuitable ground can prevent pathing. Mobs are not teleported back. Adjust the boundary or terrain, or set `mobs-bound-to-area: false` if they may roam freely.

## How do I change a mob in only one zone?

Run `/mdz zones`, open the zone, and choose **Mob mix and settings**. Set a per-zone value or leave its inheritance option on to use the mob profile. The builder's effect levels start at I; in YAML, levels start at zero, so `SPEED: 1` gives Speed II. Saving applies the zone immediately and clears its existing tracked mobs.

## Do I need to restart?

Saving a zone through `/mdz zones` applies it immediately. Restart after manual changes to `zones.yml`, mob profiles, leaderboard settings, command aliases, or registered command permissions. `/mdz reload` reloads general settings, messages, global mob settings, the shop, and portals, then clears active Darkzone mobs.

## Why does the shop reject my currency?

The shop accepts tagged ManticDarkzone reward items, not normal items that only have a matching display name. Match `dropIdToTrade` to the reward's `id`, use a real item material, and check that the player has enough of the exact currency item.

## Which PlaceholderAPI values are available?

* `%manticdarkzone_killed%`: formatted kill count.
* `%manticdarkzone_killed_raw%`: integer kill count.
* `%manticdarkzone_killed_short%`: abbreviated count.

Use them in other plugins that support PlaceholderAPI.