Adnan Gaming

Anime Dungeon & Guild Plugin: Full Concept Concept document for a Minecraft (Paper/Spigot) plugin · November 14, 2026

  1. Overview

An anime-style adventure plugin. Players join an Adventurer's Guild, climb from rank F to rank S, clear dungeons full of monsters, and earn money by turning in what they hunt. NPCs hand out missions with exact coordinates, village chiefs ask for help with story-driven quests, and monsters sometimes attack villages on their own, so the world never feels still.

The feel is that of a hunter or guild anime: gates that open into dangerous dungeons, rank exams, named bosses with dramatic entrances, and a village that needs saving.

  1. Core Gameplay Loop
  2. Join the Guild by paying a fee to the Guild NPC.
  3. Take missions from the Guild NPC or from a village chief.
  4. Travel to the given coordinates or enter a dungeon.
  5. Kill monsters and the boss.
  6. Turn in monster drops and mission proof at the Guild to get paid.
  7. Spend money on guild services, rank exams, gear and repairs.
  8. Rank up to unlock harder dungeons and better rewards, then repeat.
  9. Guild System

3.1 Joining • The player talks to a Guild NPC and pays a one-time join fee. • New members start at rank F and receive a guild card showing rank, kills and completed missions. 3.2 Turning in monster drops • Every guild monster drops a trophy item (for example Goblin Fang, Orc Hide, Wraith Essence, Demon Core). • The player gives trophies to the Guild NPC and receives money. • Payment depends on the monster tier and on the player's rank. • A small percentage can be kept by the guild as a tax, set in the config. 3.3 Paying the guild The player pays Guild NPCs for several services: • Join fee • Rank-up exam fee • Equipment repair • Guild shop purchases (potions, gear, dungeon keys) • Optional revival or teleport services 3.4 Rank-up exams • When the player has enough completed missions and kills, they can pay an exam fee at the Guild NPC. • The exam is a special fight (for example a trial boss) that must be beaten to rise one rank. • Failing costs the fee, which adds a real risk to ranking up.

  1. Ranks

Ranks follow the usual anime scale: F, E, D, C, B, A, S. • F and E: beginner area. Goblin caves, easy monsters, small rewards. • D and C: forests, orc forts, spider nests. Stronger monsters and parties become useful. • B: undead crypts. Magic-using enemies and healing bosses. • A: demon gates. Fire, strong bosses with phases. • S: the Abyss. The hardest dungeons, final bosses and the best rewards.

Higher rank means access to harder dungeons and missions, a higher payment multiplier for trophies, and rarer rewards. All costs and multipliers are configurable.

  1. Dungeons

5.1 Structure • Gate-style dungeons: the player enters through a gate and the dungeon is its own instance. • Dungeons have several floors. Each floor has a set of monsters matching the dungeon's tier. • A mini boss appears every five floors, and a final boss guards the last floor. • A dungeon key can be required to enter higher-tier dungeons. 5.2 Rules • Time limit per dungeon, with a warning before time runs out. • Party support so friends can clear dungeons together. • Loot chests at the end of floors and after the final boss. • Death penalty: the player loses some money or experience, so risk matters. • Only players of a fitting rank can enter a dungeon of that tier.

  1. Monsters and Bosses

6.1 By rank • F to E, Goblin Cave: Goblin, Slime, Wild Wolf. Mini boss: Goblin Chief. Boss: Goblin King. • D to C, Dark Forest and Orc Fort: Orc Warrior, Skeleton Archer, Giant Spider. Bosses: Orc Warlord and Spider Queen (summons spider minions). • B, Undead Crypt: Zombie Knight, Ghost, Wraith. Bosses: Death Knight and Lich (magic attacks, heals itself). • A, Demon Gate: Imp, Demon Soldier, Hellhound. Bosses: Demon General and Fire Drake (fire breath). • S, Abyss: Shadow Beast, Void Knight. Final bosses: Void Emperor and Ancient Dragon. 6.2 Boss design • Name and health shown on a boss bar. • A dramatic title on spawn, such as "Goblin King has awakened!". • Rage phase at 50% health: more speed and damage. • At 25% health: minion summons or a special skill. • Rare drops: boss weapon, special title and a large amount of money.

Every monster's health, damage and drops are set in the config.

  1. Mission System

7.1 Guild mission NPC • A mission NPC gives missions that include coordinates. • The player must travel there and kill a named boss or master monster. • A compass or waypoint points toward the coordinates. • Mission types: boss kill, monster collection, dungeon clear and escort. • Daily and weekly missions give regular goals. • Higher-rank missions pay more and may give rare items. 7.2 Village chief missions • Each village chief gives separate, story-based missions, also with coordinates. • Examples: ◦ Bandit Leader, who stole the villagers' goods. ◦ Cursed Wolf, who attacks the village at night. ◦ Forest Witch, hiding in the woods. ◦ Stone Golem, guarding an old temple. • Rewards are special: rare items, titles and money. Completing chief missions can improve the player's reputation in that village. 7.3 Mission flow

  1. Talk to the NPC or chief and accept a mission.
  2. Receive the objective and the coordinates.
  3. Reach the location and defeat the target.
  4. Return to the NPC to claim the reward.
  5. Missions can be abandoned and cannot be taken twice at once.
  6. Village Raids

Monsters can attack villages by themselves, without any player starting it. • Raids start at random: the plugin checks each village at a set interval and starts a raid based on a chance percentage, but only when a player is nearby. A cooldown prevents back-to-back raids. • A raid has several waves of monsters, then a boss after the last wave. • Monsters target villagers first, then players. • A boss bar shows the current wave, then the boss's health. • At 50% health the boss enters a rage phase with more speed and strength. • Victory: the boss is killed. Defeat: all villagers die or the time limit runs out. • Players who fought in the raid receive rewards, set by configurable commands (money, items). • Admins can start or stop a raid with a command for testing.

This makes villages feel alive and gives players a reason to stay near them and defend them.

  1. Economy

• Money comes from trophy turn-ins, mission rewards, dungeon loot and raid rewards. • Money goes to guild fees, exams, repairs, shop purchases and keys. • Reward and price values are all configurable so server owners can balance their own economy. • Integration with Vault lets the plugin work with common economy plugins.

  1. Progression Extras

• Player level, mana and skills (sword skills, magic) for the anime combat feel. • Titles, such as "Goblin Slayer", earned from achievements. • Leaderboards for top hunters by rank, kills and missions. • GUI menus for the guild card, mission board and shop.

  1. Commands and Permissions

• /villageraid start <village>: start a raid for testing. • /villageraid stop <village>: stop a running raid. • /villageraid list: list configured villages. • Admin permission: animedungeon.admin. • Further commands, such as guild, mission and dungeon commands, will follow the same pattern as the system grows.

  1. Configuration

Everything important is set in config.yml: • Villages (world, coordinates, radius) • Raid timing, chance, cooldown and time limit • Waves and boss settings (mob types, counts, name, health) • Monster health multiplier and drop rules • Reward commands and all in-game messages • Later: ranks, prices, dungeon layouts and mission lists

  1. Technical Notes

• Platform: Paper or Spigot, Minecraft 1.21.3 or newer, Java 21. • Economy: Vault for money. • NPCs: either the Citizens plugin or custom-named villagers handled by the plugin. • Data: player rank, kills and mission progress stored in YAML at first, with a move to SQLite if the server grows. • Boss bars, titles and scheduled tasks use the standard server API.

  1. Development Roadmap
  2. Village raids: first version written (waves, boss, rage phase, rewards, commands).
  3. Guild system: NPC, join fee, ranks, trophy turn-in and shop.
  4. Missions: guild mission NPC and village chief missions with coordinates and boss targets.
  5. Dungeons: instanced floors, mini bosses, final bosses, keys, parties.
  6. Progression: levels, skills, titles and leaderboards.
  7. Polish: GUI menus, balance testing and configuration for server owners.
  8. Mob Spawning and Admin Tools

15.1 How mobs spawn • Raid and dungeon monsters are spawned directly by the plugin, so they do not depend on natural spawn rules. • The server difficulty must not be Peaceful, because Peaceful removes hostile mobs. • The chunks around a village or dungeon must be loaded, which is normally the case when a player is nearby. • Named monsters such as Goblin King or Orc Warlord are vanilla mobs with a custom name, health, effects and drops. They are not new mob types. 15.2 Creative mode and spawn eggs • Vanilla spawn eggs are already in the creative menu, but mobs spawned from them are ordinary mobs. They are not part of any raid or dungeon. • A plugin cannot add new items to the creative menu itself, since that needs a client mod. Instead, the plugin gives items through commands and a GUI. 15.3 Admin GUI (/dungeonadmin) • Custom spawn eggs for guild monsters and bosses, with name, health and drops already set. • Dungeon keys, guild cards and trophy items. • Usable only with the admin permission or in creative mode. • Test tools: start or stop a village raid and spawn a boss at the admin's location.

Kodari AI
KodariNov 14 at 3:08 am 3
AnimeGuildAdventures
An anime-style adventure plugin where players join an Adventurer's Guild, climb ranks from F to S, and clear instanced dungeons. Features guild NPCs handling join fees, trophy turn-ins, rank-up exams, and shops. Village chiefs offer story-driven missions with coordinates and boss targets. Random village raids spawn waves of monsters with rage-phase bosses, rewarding defenders. Includes configurable ranks, dungeon tiers, monster stats, economy via Vault, boss bars, titles, and admin commands. Uses the GUI framework for guild cards, mission boards, and shops.
  1. Build the Java 21 plugin entry point, configuration, persistence, and Vault hookup.

  2. Implement guild membership, ranks, trophies, missions, and dungeon entry.

  3. Add village raids, boss phases/rewards, admin controls, and player-facing commands/menus.

Built the plugin with configurable village raids, waves and boss phases, raid rewards and admin controls; guild membership, F–S rank exams, trophy turn-ins, Vault or YAML-backed economy, coordinate-based missions, and floor-based dungeons. Player data persists in YAML, and guild and admin menus are included.

Dungeon runs currently use configured shared arena locations and are solo—not isolated party instances. Daily/weekly mission rotations, titles, leaderboards, and combat skills are not included yet.

Adnan Gaming

26.3 paper

Kodari AI
KodariNov 14 at 3:09 am 1

Target this as a Paper plugin; I’ll update its declared API version to 26.3.

Updated plugin.yml to declare Paper API version 26.3.

Adnan Gaming

my version is 26.3 paper

Kodari AI
KodariNov 14 at 3:09 am 1

Understood—your server is Paper 26.3. The plugin descriptor is set to api-version: '26.3'; that declares the API version, but this project has no Gradle build file to set the Paper 26.3 compile dependency.

Adnan Gaming

Prompt: Upgrade the AnimeDungeonGuild Plugin Copy everything below the line into an AI coding tool (for example Claude Code) and attach AnimeDungeonGuild.jar.

Task I have a compiled Minecraft Paper/Spigot plugin, AnimeDungeonGuild.jar, and I do not have its source code. First decompile the jar (for example with Vineflower or CFR) into a Maven or Gradle project, make sure it builds again, then add the features below and give me the full source project plus the rebuilt jar.

Current plugin facts • Name: AnimeDungeonGuild, version 1.0.0, main class com.kodari.animedungeon.AnimeDungeonPlugin, api-version 1.21, soft dependency on Vault. • Target: Paper/Spigot 1.21.3+ on Java 21. Keep XSeries shaded and relocated (com.kodari.animedungeon.libs.com.cryptomorin.xseries) so attributes and materials stay version-safe. • Packages: command (GuildCommand, RaidCommand, DungeonAdminCommand), data (PlayerProfile, ProfileStore saving players.yml), dungeon (DungeonManager), economy (EconomyService with Vault or an internal wallet), guild (GuildMenu, GuildRank, MissionService), listener (GameListener), raid (VillageRaidManager). • Commands: /guild, /villageraid (permission animedungeon.admin), /dungeonadmin. In-game messages are in English. • Config sections: missions.entries, dungeons, raid settings and villages. A mission only has a name, rank, mob type, amount, a world with x, y, z, a radius and a reward.

Problems to fix

  1. Missions show coordinates but no monsters are there. The plugin only counts kills of the mission mob inside the radius and never spawns anything.
  2. Dungeons are only a teleport to a configured coordinate. Nothing is built, and nothing opens by itself anywhere in the world.
  3. /dungeonadmin can be opened by any player in creative mode. It should require only animedungeon.admin.
  4. There is no command for an admin to give, take or set money.
  5. Trophy payouts exist only for ZOMBIE, SKELETON, SPIDER, CREEPER, WITCH and RAVAGER.
  6. Peaceful difficulty silently removes every hostile mob.

Features to add

  1. Mission monsters

• When a player accepts a mission, spawn the target mobs inside the mission radius, up to the configured amount. Top them up if they die by other causes or despawn. • Mission mobs get a custom name and scaled health from config, and are removed when the mission is abandoned or claimed. • Support a boss: true option with boss-type, boss-name and boss-health for master and boss missions. Show a boss bar with name and health, and a title on spawn. • Boss rage phase at 50% health (more speed and strength), and a minion summon at 25%. • Spawn only when the chunk is loaded and a player is near. Never spawn mobs on the player's position.

  1. Guild NPC and Guild Hall

• /guild setnpc places a Guild NPC (a named villager with AI disabled and invulnerable) where the admin stands. Right-clicking opens the existing guild menu. Add /guild removenpc. • Store the Guild Hall location. New players get a chat message with its coordinates on first join, and /guild locate points a compass to it. An optional paid /guild tp teleport, with a configurable fee.

  1. Village chief missions

• A Village Chief NPC (/guild setchief <village>) gives story missions with coordinates and boss targets, using the same spawn logic as guild missions. • Default chief missions: Bandit Leader (stolen goods), Cursed Wolf (night attacks), Forest Witch (hiding in the woods), Stone Golem (guarding an old temple). • Rewards: money, rare items and a title. Optionally track reputation per village.

  1. Random Gates and real dungeons

• A scheduler opens a Gate at a random safe location within configured world bounds at a configurable interval and chance. The gate has a rank tier, a time limit and a chat announcement such as "B-rank Gate opened at X Y Z". It closes when the time runs out. • Entering a gate (or running the existing dungeon enter command) creates an instanced dungeon: build a simple arena with floors automatically (platform, walls, spawn points) in a dedicated void world, so no manual building is required. Optionally load a WorldEdit schematic if one is configured. • Keep the existing floors, time limit, trophy and reward logic. Add a mini boss every 5 floors, the final boss with a boss bar and rage phase, party support, a death penalty (configurable money or XP loss) and a safe return to the entry location on exit, death or time-out.

  1. Admin and economy

• Add /guild admin give|take|set <player> <amount>, restricted to animedungeon.admin. • Remove the creative-mode shortcut from /dungeonadmin and from the admin spawn eggs. • Add custom spawn eggs and items for Goblin King, Orc Warlord and the other bosses, a dungeon key, a guild card and trophy items. Eggs spawn the custom named mob with its preset health and drops. • Make trophy payouts config-driven for any mob, and use a default price for unlisted hostile mobs. • Warn in the console at startup, and when a raid or mission starts, if the world difficulty is Peaceful.

  1. Village raids

• Keep the existing random raids and waves. Make raid and gate announcements configurable and let the admin start or stop a raid or gate with a command for testing.

Rules • Keep the existing commands, permissions and players.yml data compatible. Add new config keys with sensible defaults, and write new messages in English. • Use only the Paper/Spigot API and Vault. No network calls, no external processes, no reflection beyond what XSeries needs. • Run each long task off the main thread only when it is safe, and keep all Bukkit API calls on the main thread.

Deliverables

  1. The complete source project (Maven or Gradle) that builds without errors.
  2. The rebuilt AnimeDungeonGuild.jar.
  3. An updated default config.yml with comments.
  4. A short test checklist: join the guild, accept a mission and see the monsters, kill them and claim the reward, open a gate and finish a dungeon, trigger a raid, and use the admin commands
Kodari AI
KodariNov 14 at 3:51 pm 5
  1. Mission mobs: spawn, replenish, track boss phases, and clean up on abandon/claim.

  2. Guild NPCs, chief missions, hall location, and economy admin commands.

  3. Random gates, generated dungeon arenas, party/death handling, and boss rewards.

  4. Configurable trophy payouts, admin items/permissions, peaceful warnings, and raid/gate test controls.

[Generation stopped]

Adnan Gaming

speed and strength), and a minion summon at 25%. • Spawn only when the chunk is loaded and a player is near. Never spawn mobs on the player's position.

  1. Guild NPC and Guild Hall

• /guild setnpc places a Guild NPC (a named villager with AI disabled and invulnerable) where the admin stands. Right-clicking opens the existing guild menu. Add /guild removenpc. • Store the Guild Hall location. New players get a chat message with its coordinates on first join, and /guild locate points a compass to it. An optional paid /guild tp teleport, with a configurable fee.

  1. Village chief missions

• A Village Chief NPC (/guild setchief <village>) gives story missions with coordinates and boss targets, using the same spawn logic as guild missions. • Default chief missions: Bandit Leader (stolen goods), Cursed Wolf (night attacks), Forest Witch (hiding in the woods), Stone Golem (guarding an old temple). • Rewards: money, rare items and a title. Optionally track reputation per village.

  1. Random Gates and real dungeons

• A scheduler opens a Gate at a random safe location within configured world bounds at a configurable interval and chance. The gate has a rank tier, a time limit and a chat announcement such as "B-rank Gate opened at X Y Z". It closes when the time runs out. • Entering a gate (or running the existing dungeon enter command) creates an instanced dungeon: build a simple arena with floors automatically (platform, walls, spawn points) in a dedicated void world, so no manual building is required. Optionally load a WorldEdit schematic if one is configured. • Keep the existing floors, time limit, trophy and reward logic. Add a mini boss every 5 floors, the final boss with a boss bar and rage phase, party support, a death penalty (configurable money or XP loss) and a safe return to the entry location on exit, death or time-out.

  1. Admin and economy

• Add /guild admin give|take|set <player> <amount>, restricted to animedungeon.admin. • Remove the creative-mode shortcut from /dungeonadmin and from the admin spawn eggs. • Add custom spawn eggs and items for Goblin King, Orc Warlord and the other bosses, a dungeon key, a guild card and trophy items. Eggs spawn the custom named mob with its preset health and drops. • Make trophy payouts config-driven for any mob, and use a default price for unlisted hostile mobs. • Warn in the console at startup, and when a raid or mission starts, if the world difficulty is Peaceful.

  1. Village raids

• Keep the existing random raids and waves. Make raid and gate announcements configurable and let the admin start or stop a raid or gate with a command for testing.

Rules • Keep the existing commands, permissions and players.yml data compatible. Add new config keys with sensible defaults, and write new messages in English. • Use only the Paper/Spigot API and Vault. No network calls, no external processes, no reflection beyond what XSeries needs. • Run each long task off the main thread only when it is safe, and keep all Bukkit API calls on the main thread.

Deliverables

  1. The complete source project (Maven or Gradle) that builds without errors.
  2. The rebuilt AnimeDungeonGuild.jar.
  3. An updated default config.yml with comments.
  4. A short test checklist: join the guild, accept a mission and see the monsters, kill them and claim the reward, open a gate and finish a dungeon, trigger a raid, and use the admin commands.

Addendum: Commands and Triggers (overrides earlier wording) • Add /dungeon enter [name], /dungeon leave and /dungeon list. /dungeon enter must build or load the dungeon instance immediately, teleport the player in and spawn the first floor's monsters, with no manual building. Without a name it picks the best dungeon for the player's rank. • Mission monsters spawn when the player arrives within a trigger radius of the mission coordinates, not when the mission is accepted. This replaces the earlier wording in feature 1. Everything else in that feature stays: boss bar, rage phase, top-up of killed monsters, and removal on claim or abandon. • Random Gates and /dungeon enter must share the same instance system. Add /guild locate gate to point the compass at the nearest open gate, and the admin test commands /dungeon gate open <rank> and /dungeon gate close <id>.

Kodari AI
KodariNov 14 at 4:08 pm 8
  • Update mission spawning to trigger on proximity, with safe spawning, replenishment, boss phases, and cleanup.

  • Add guild/chief NPCs, hall services, admin economy, and custom admin items.

  • Unify random gates and /dungeon around generated dungeon instances; complete raid controls, config, and test checklist.

Dungeon entry now uses generated, separated void-world arenas, with floor progression, boss bars, party invitations, safe returns, and shared gate handling for manual and random entry. Next I’m tightening admin-only test items and making trophy values work for unlisted hostile mobs.

Updated the workspace for Paper 26.3 / Java 21. It now includes proximity-triggered mission spawns, guild and chief NPC services, configurable trophy prices, admin-only test items, raids with configurable announcements and Peaceful warnings, plus generated dungeon arenas, party runs, and random gates. Added the /dungeon commands and Gradle project files.

Not completed: No original AnimeDungeonGuild.jar was attached, so I couldn’t decompile it or verify compatibility against that binary. XSeries remains Kodari-managed; I did not add shading or relocation. I also haven’t verified a successful build.

To get the rebuilt JAR in Kodari: click Compile (on phone: ⋮ → Compile Project), click Compile in the dialog, then Download on the successful build. Use Auto-fix if the build reports errors.

Test checklist

  1. Join the guild, set the NPC with /guild setnpc, then accept a mission and travel near its configured coordinates; the mobs should spawn there. Kill the objective and claim the reward.

  2. Run /dungeon enter goblin-cave, clear each floor and the final boss, then test /dungeon leave.

  3. As an admin, open a gate with /dungeon gate open F, enter it, and close it with /dungeon gate close <id>.

  4. Start and stop a village raid with /villageraid start example and /villageraid stop example.

  5. Check /guild admin give|take|set <player> <amount> and /dungeonadmin; verify spawn eggs require animedungeon.admin.

Adnan Gaming

How to download this plugin

Kodari AI
KodariNov 14 at 4:10 pm 1
  1. Click Compile in the top bar. On phone, tap ⋮ → Compile Project.

  2. In the window, click Compile.

  3. When the build succeeds, click Download to get the plugin JAR.

Adnan Gaming

Should I delete the previous version of the plugin and install this version on my server?

Kodari AI
KodariNov 14 at 4:15 pm 1

Replace the old plugin JAR only after the new project compiles successfully and you’ve downloaded the rebuilt JAR. I haven’t verified a successful build yet.

Stop the server, back up the old JAR and the plugin’s data/config files (especially players.yml), then remove the old JAR and put the new one in plugins/. Don’t leave both JARs in that folder, or the plugin may load twice. Start the server and check the console for errors; keep your backups until you’ve confirmed the plugin and player data work.

Adnan Gaming

Please create a data pack for me. Everything in it should work properly.

Kodari AI
KodariNov 14 at 4:45 pm 1

This project is a Paper plugin workspace, so I can’t create a datapack here. Kodari supports datapacks—switch to a datapack project to build it.

Switch to datapack

Adnan Gaming

Please create a data pack for me. Everything in it should work properly.

Kodari AI
KodariNov 14 at 4:46 pm 1

This is a Paper plugin project, but you’re asking for a vanilla datapack. Kodari supports datapacks—switch projects and I can create one for you.

Switch to datapack

Adnan Gaming

I’m putting together the data pack; now, go ahead and create the data pad.

Kodari AI
KodariNov 14 at 4:47 pm 1

This is a Paper plugin project, so I can’t create a datapack in this workspace. Switch to a datapack project and I can build it there.

Switch to datapack

Adnan Gaming

Prompt: Upgrade the AnimeDungeonGuild Plugin Copy everything below the line into an AI coding tool (for example Claude Code) and attach AnimeDungeonGuild.jar.

Task I have a compiled Minecraft Paper/Spigot plugin, AnimeDungeonGuild.jar, and I do not have its source code. First decompile the jar (for example with Vineflower or CFR) into a Maven or Gradle project, make sure it builds again, then add the features below and give me the full source project plus the rebuilt jar.

Current plugin facts • Name: AnimeDungeonGuild, version 1.0.0, main class com.kodari.animedungeon.AnimeDungeonPlugin, api-version 1.21, soft dependency on Vault. • Target: Paper/Spigot 1.21.3+ on Java 21. Keep XSeries shaded and relocated (com.kodari.animedungeon.libs.com.cryptomorin.xseries) so attributes and materials stay version-safe. • Packages: command (GuildCommand, RaidCommand, DungeonAdminCommand), data (PlayerProfile, ProfileStore saving players.yml), dungeon (DungeonManager), economy (EconomyService with Vault or an internal wallet), guild (GuildMenu, GuildRank, MissionService), listener (GameListener), raid (VillageRaidManager). • Commands: /guild, /villageraid (permission animedungeon.admin), /dungeonadmin. In-game messages are in English. • Config sections: missions.entries, dungeons, raid settings and villages. A mission only has a name, rank, mob type, amount, a world with x, y, z, a radius and a reward.

Problems to fix

  1. Missions show coordinates but no monsters are there. The plugin only counts kills of the mission mob inside the radius and never spawns anything.
  2. Dungeons are only a teleport to a configured coordinate. Nothing is built, and nothing opens by itself anywhere in the world.
  3. /dungeonadmin can be opened by any player in creative mode. It should require only animedungeon.admin.
  4. There is no command for an admin to give, take or set money.
  5. Trophy payouts exist only for ZOMBIE, SKELETON, SPIDER, CREEPER, WITCH and RAVAGER.
  6. Peaceful difficulty silently removes every hostile mob.

Features to add

  1. Mission monsters

• When a player accepts a mission, spawn the target mobs inside the mission radius, up to the configured amount. Top them up if they die by other causes or despawn. • Mission mobs get a custom name and scaled health from config, and are removed when the mission is abandoned or claimed. • Support a boss: true option with boss-type, boss-name and boss-health for master and boss missions. Show a boss bar with name and health, and a title on spawn. • Boss rage phase at 50% health (more speed and strength), and a minion summon at 25%. • Spawn only when the chunk is loaded and a player is near. Never spawn mobs on the player's position.

  1. Guild NPC and Guild Hall

• /guild setnpc places a Guild NPC (a named villager with AI disabled and invulnerable) where the admin stands. Right-clicking opens the existing guild menu. Add /guild removenpc. • Store the Guild Hall location. New players get a chat message with its coordinates on first join, and /guild locate points a compass to it. An optional paid /guild tp teleport, with a configurable fee.

  1. Village chief missions

• A Village Chief NPC (/guild setchief <village>) gives story missions with coordinates and boss targets, using the same spawn logic as guild missions. • Default chief missions: Bandit Leader (stolen goods), Cursed Wolf (night attacks), Forest Witch (hiding in the woods), Stone Golem (guarding an old temple). • Rewards: money, rare items and a title. Optionally track reputation per village.

  1. Random Gates and real dungeons

• A scheduler opens a Gate at a random safe location within configured world bounds at a configurable interval and chance. The gate has a rank tier, a time limit and a chat announcement such as "B-rank Gate opened at X Y Z". It closes when the time runs out. • Entering a gate (or running the existing dungeon enter command) creates an instanced dungeon: build a simple arena with floors automatically (platform, walls, spawn points) in a dedicated void world, so no manual building is required. Optionally load a WorldEdit schematic if one is configured. • Keep the existing floors, time limit, trophy and reward logic. Add a mini boss every 5 floors, the final boss with a boss bar and rage phase, party support, a death penalty (configurable money or XP loss) and a safe return to the entry location on exit, death or time-out.

  1. Admin and economy

• Add /guild admin give|take|set <player> <amount>, restricted to animedungeon.admin. • Remove the creative-mode shortcut from /dungeonadmin and from the admin spawn eggs. • Add custom spawn eggs and items for Goblin King, Orc Warlord and the other bosses, a dungeon key, a guild card and trophy items. Eggs spawn the custom named mob with its preset health and drops. • Make trophy payouts config-driven for any mob, and use a default price for unlisted hostile mobs. • Warn in the console at startup, and when a raid or mission starts, if the world difficulty is Peaceful.

  1. Village raids

• Keep the existing random raids and waves. Make raid and gate announcements configurable and let the admin start or stop a raid or gate with a command for testing.

Rules • Keep the existing commands, permissions and players.yml data compatible. Add new config keys with sensible defaults, and write new messages in English. • Use only the Paper/Spigot API and Vault. No network calls, no external processes, no reflection beyond what XSeries needs. • Run each long task off the main thread only when it is safe, and keep all Bukkit API calls on the main thread.

Deliverables

  1. The complete source project (Maven or Gradle) that builds without errors.
  2. The rebuilt AnimeDungeonGuild.jar.
  3. An updated default config.yml with comments.
  4. A short test checklist: join the guild, accept a mission and see the monsters, kill them and claim the reward, open a gate and finish a dungeon, trigger a raid, and use the admin commands.

Addendum: Commands and Triggers (overrides earlier wording) • Add /dungeon enter [name], /dungeon leave and /dungeon list. /dungeon enter must build or load the dungeon instance immediately, teleport the player in and spawn the first floor's monsters, with no manual building. Without a name it picks the best dungeon for the player's rank. • Mission monsters spawn when the player arrives within a trigger radius of the mission coordinates, not when the mission is accepted. This replaces the earlier wording in feature 1. Everything else in that feature stays: boss bar, rage phase, top-up of killed monsters, and removal on claim or abandon. • Random Gates and /dungeon enter must share the same instance system. Add /guild locate gate to point the compass at the nearest open gate, and the admin test commands /dungeon gate open <rank> and /dungeon gate close <id>.

Kodari AI
KodariNov 14 at 4:48 pm 1

This workspace is for datapacks, but your request is to upgrade a Paper/Spigot plugin. Kodari supports Paper plugins; switch to a plugin project and attach AnimeDungeonGuild.jar there.

Switch to Paper plugin

Kodari can make mistakes. Review important code before using.
Files
src
Code
15 1,863
src/main/java/com/kodari/animedungeon/AnimeDungeonPlugin.java
package com.kodari.animedungeon;

import com.kodari.animedungeon.command.DungeonAdminCommand;
import com.kodari.animedungeon.command.GuildCommand;
import com.kodari.animedungeon.command.RaidCommand;
import com.kodari.animedungeon.data.ProfileStore;
import com.kodari.animedungeon.dungeon.DungeonManager;
import com.kodari.animedungeon.economy.EconomyService;
import com.kodari.animedungeon.guild.GuildMenu;
import com.kodari.animedungeon.guild.MissionService;
import com.kodari.animedungeon.raid.VillageRaidManager;
import com.kodari.animedungeon.listener.GameListener;
import net.milkbowl.vault.economy.Economy;
import org.bukkit.Bukkit;
import org.bukkit.NamespacedKey;
import org.bukkit.plugin.RegisteredServiceProvider;
import org.bukkit.plugin.java.JavaPlugin;

public final class AnimeDungeonPlugin extends JavaPlugin {
    private ProfileStore profileStore;
    private EconomyService economyService;
    private MissionService missionService;
    private DungeonManager dungeonManager;
    private VillageRaidManager raidManager;
    private GuildMenu guildMenu;
    private NamespacedKey trophyKey;
    private NamespacedKey adminSpawnKey;
    private NamespacedKey dungeonMobKey;
    private NamespacedKey rankExamKey;
    private NamespacedKey rankExamOwnerKey;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        trophyKey = new NamespacedKey(this, "trophy");
        adminSpawnKey = new NamespacedKey(this, "admin_spawn");
        dungeonMobKey = new NamespacedKey(this, "dungeon_mob");
        rankExamKey = new NamespacedKey(this, "rank_exam");
        rankExamOwnerKey = new NamespacedKey(this, "rank_exam_owner");

        profileStore = new ProfileStore(this);
        profileStore.load();
        economyService = new EconomyService(this, profileStore, setupEconomy());
        missionService = new MissionService(this, profileStore, economyService);
        dungeonManager = new DungeonManager(this, profileStore, economyService);
        raidManager = new VillageRaidManager(this, economyService);
        guildMenu = new GuildMenu(this, profileStore);

        Bukkit.getPluginManager().registerEvents(new GameListener(this), this);
        Bukkit.getPluginManager().registerEvents(guildMenu, this);
        getCommand("guild").setExecutor(new GuildCommand(this));
        getCommand("villageraid").setExecutor(new RaidCommand(this));
        getCommand("dungeonadmin").setExecutor(new DungeonAdminCommand(this));
        raidManager.startAutomaticChecks();
        getLogger().info("Anime Dungeon & Guild enabled.");
    }

    @Override
    public void onDisable() {
        if (raidManager != null) raidManager.shutdown();
        if (dungeonManager != null) dungeonManager.shutdown();
        if (profileStore != null) profileStore.save();
    }

    private Economy setupEconomy() {
        if (Bukkit.getPluginManager().getPlugin("Vault") == null) {
            getLogger().info("Vault economy not found; using the plugin's stored wallet balances.");
            return null;
        }
        RegisteredServiceProvider<Economy> registration = getServer().getServicesManager().getRegistration(Economy.class);
        if (registration == null || registration.getProvider() == null) {
            getLogger().warning("Vault is installed but no economy provider is registered; using stored wallet balances.");
            return null;
        }
        getLogger().info("Vault economy hooked: " + registration.getProvider().getName());
        return registration.getProvider();
    }

    public ProfileStore profiles() { return profileStore; }
    public EconomyService economy() { return economyService; }
    public MissionService missions() { return missionService; }
    public DungeonManager dungeons() { return dungeonManager; }
    public VillageRaidManager raids() { return raidManager; }
    public GuildMenu guildMenu() { return guildMenu; }
    public NamespacedKey trophyKey() { return trophyKey; }
    public NamespacedKey adminSpawnKey() { return adminSpawnKey; }
    public NamespacedKey dungeonMobKey() { return dungeonMobKey; }
    public NamespacedKey rankExamKey() { return rankExamKey; }
    public NamespacedKey rankExamOwnerKey() { return rankExamOwnerKey; }
}