Skip to content
AramDungeons

Installation

Server Requirements

  • Paper or Folia 1.21.10
  • Java 21
  • File access for plugin data folder and schematic imports
  • An existing world dedicated to pasted dungeon instances

Dependencies

Required runtime plugins:

  • FastAsyncWorldEdit
  • MythicMobs
  • MMOItems
  • MythicLib

Optional runtime plugin:

  • PlaceholderAPI
  • TAB

Install Sequence

  1. Put AramDungeons.jar in server plugins/.
  2. Put required dependency jars in plugins/.
  3. Create or prepare world used by instance-world in main-config.yml.
  4. Start server once.
  5. Stop server and review generated files before editing anything.

First Startup Output

After first boot, expect plugin to generate files like:

plugins/AramDungeons/
├── main-config.yml
├── message-config.yml
├── economy-config.yml
├── stat-config.yml
├── augment-config.yml
├── equipment-config.yml
├── imports/
├── snapshots/
└── dungeons/
    ├── tutorial.yml
    └── hard-mode.yml

Notes:

  • imports/ is where /ad admin schematic import ... looks for schematic files.
  • Each dungeons/<id>.yml is one persisted dungeon. New files contain three empty stages and remain disabled until validation passes.
  • A legacy top-level dungeon-config.yml is migrated once and renamed to dungeon-config.yml.migrated.
  • snapshots/ contains crash-safe player restore data while runs are active.
  • instance-world must already exist if you want test runs to paste successfully.

Jar Placement Example

plugins/
├── AramDungeons.jar
├── FastAsyncWorldEdit.jar
├── MythicMobs.jar
├── MMOItems.jar
├── MythicLib.jar
└── PlaceholderAPI.jar  # optional