Twligh
📎 1 file 13,487 chars
📄
pasted-code-1790752243842.txt
txt 811 lines
▶
# Build a Professional Minecraft Home + Spawner Plugin

Act as a senior Minecraft Java plugin developer and build a production-ready Paper/Spigot plugin.

## IMPORTANT

**Ignore Lifesteal completely for now.**

Do NOT implement, modify, or depend on any Lifesteal functionality.

The plugin being built in this task is focused on:

1. Home system
2. World Group system
3. Spawner system
4. Spawner upgrades
5. Mob spawning
6. Mob loot
7. Money rewards
8. Player progression/ranks
9. Admin GUI/configuration

---

# 1. WORLD GROUP SYSTEM

Create a strict World → Group system similar in concept to Multiverse-Inventories.

The administrator should be able to create groups and assign multiple worlds to the same group.

Use placeholders in documentation:

* ``
* ``

Do NOT hardcode actual server world names.

Example concept:

``
``
``

can belong to:

``

Another world can belong to:

``.

## Group behavior

Each group should have independent settings.

A player's active group is determined from their CURRENT Minecraft world.

Never assume a global group.

Never automatically enable a feature in an unknown world.

If a world is not assigned to a group, group-based features must be disabled there.

World/group resolution must be handled by ONE central service, for example:

`WorldGroupService`

All features must use this service.

Do not duplicate world-checking logic across different classes.

---

# 2. HOME SYSTEM

Create a complete `/home` system.

Players should be able to create and manage multiple homes.

Commands:

`/sethome `

`/home `

`/delhome `

`/homes`

`/home `

`/homelist`

Support configurable maximum homes based on permissions/ranks.

Example:

`home.default`

`home.vip`

`home.mvp`

etc.

Do not hardcode the rank names.

The administrator should be able to define rank limits later.

---

# 3. WORLD-SPECIFIC HOMES

Homes must remember:

* World
* X
* Y
* Z
* Yaw
* Pitch

A player can set a home in one world and teleport back to that exact world/location.

Before teleporting:

* Check that the world still exists.
* Check that the world is loaded.
* Safely handle deleted/unloaded worlds.
* Prevent teleportation to invalid locations.
* Respect the world/group rules.

Homes should NOT randomly teleport players to another world if the original world is unavailable.

---

# 4. GROUP-AWARE HOME SYSTEM

Homes should understand the World Group system.

The administrator can configure whether homes are:

* Global
* Group-specific
* World-specific

For group-specific mode:

A home created in `` belonging to `` should belong to ``.

When the player is in another world belonging to ``, that home should not automatically appear if group isolation is enabled.

Create configurable behavior for this.

---

# 5. HOME GUI

Create a modern inventory GUI for homes.

Example:

`/homes`

opens a GUI containing the player's homes.

Each home should show:

* Home name
* World
* Group
* Coordinates
* Icon
* Creation information

Clicking a home should teleport the player.

Allow configurable GUI title, size, icons, lore and sounds.

Add:

* Teleport button
* Delete button
* Back button
* Next/previous page

Prevent unauthorized inventory manipulation.

---

# 6. SPAWNER SYSTEM

Create a powerful custom Spawner system similar to large Minecraft network servers.

Players should be able to obtain custom spawners for different mobs.

Do NOT rely only on vanilla spawner behavior.

Create your own controlled spawning system.

---

# 7. 10+ SPAWNER TYPES

Create support for at least 10 configurable spawner types.

Examples:

1. Zombie
2. Skeleton
3. Spider
4. Creeper
5. Blaze
6. Iron Golem
7. Enderman
8. Witch
9. Pig
10. Cow

The system must be designed so administrators can add more mobs without modifying Java code.

Do not hardcode the 10 mobs into the core system.

---

# 8. SPAWNER TIERS / LEVELS

Every spawner should have upgrade levels.

Example concept:

Level 1
Level 2
Level 3
Level 4
Level 5
...
Level N

Do NOT hardcode a maximum level.

The administrator should be able to define it.

Each level can change:

* Spawn delay
* Spawn amount
* Maximum nearby mobs
* Spawn radius
* Drop multiplier
* Money multiplier
* Experience multiplier
* Special abilities

Example:

Level 1:

Slow spawning + normal drops

Level 5:

Faster spawning + increased drops

Level 10:

Very fast spawning + increased money + increased loot

---

# 9. SPAWNER UPGRADE SYSTEM

Create:

`/spawner upgrade`

or an equivalent GUI-based upgrade system.

Prefer a GUI.

The player should be able to:

* View current spawner level
* View next level
* View upgrade cost
* View benefits
* Upgrade the spawner

Upgrade costs should be configurable.

Use Vault for economy.

Do NOT create your own economy system.

---

# 10. SPAWNER GUI

Create a modern GUI.

When a player interacts with a spawner, open a GUI showing:

* Mob type
* Current level
* Next level
* Spawn speed
* Mob amount
* Nearby mob limit
* Loot multiplier
* Money multiplier
* Upgrade cost
* Current owner
* Storage information

Buttons:

* Upgrade
* Collect
* Settings
* Information
* Close

Make the GUI configurable.

---

# 11. SPAWNER OWNERSHIP

Each spawner should have an owner UUID.

Support:

* Owner
* Trusted players
* Public/private access

Example:

The owner can configure who can:

* Open spawner GUI
* Upgrade spawner
* Collect loot
* Change settings
* Break spawner

Use UUIDs rather than usernames.

---

# 12. SPAWNER LOCATION

Spawner data must store:

* World
* X
* Y
* Z
* Mob type
* Level
* Owner UUID
* Upgrade data
* Storage data

If the spawner is broken:

Handle its data safely.

Prevent duplication exploits.

Prevent players from duplicating spawners through:

* Breaking
* Dropping
* Reloading
* Server restart
* Chunk unload/load
* Piston movement
* Explosion
* Hopper interaction

---

# 13. MOB SPAWNING

Create an optimized custom spawning manager.

Do NOT run a heavy repeating task for every spawner.

Use a centralized scheduler.

Only process spawners when necessary.

Check:

* Chunk loaded
* World loaded
* Player proximity
* Mob limit
* Spawn conditions
* Spawner enabled state

Avoid unnecessary CPU usage.

The system must work efficiently with hundreds/thousands of spawners.

---

# 14. SPAWNER LOOT

Each mob type should have configurable loot.

For example:

Zombie:

* Rotten Flesh
* Iron
* Rare drops

Skeleton:

* Bone
* Arrow
* Rare drops

Iron Golem:

* Iron
* Rare drops

Loot must be configurable.

Support:

* Item
* Amount
* Chance
* Loot multiplier

Do not hardcode loot tables.

---

# 15. MONEY REWARDS

Integrate with Vault.

Players can earn money from spawner-generated mobs.

Example:

Zombie kill:

`$10`

Iron Golem:

`$100`

etc.

Values must be configurable.

Support:

* Base money reward
* Spawner-level multiplier
* Loot multiplier
* Optional player multiplier

Do NOT directly modify Vault balance without checking economy availability.

If Vault/economy is unavailable, fail safely.

---

# 16. AUTO SELL / AUTO COLLECT

Design the system so it can support:

* Manual collection
* Automatic collection
* Automatic selling

For example:

Spawner GUI → Storage → Sell All

The player can collect generated items or sell them for Vault money.

All behavior must be configurable.

---

# 17. RANK / PROGRESSION SYSTEM

Create a generic progression system.

Do NOT hardcode rank names.

Administrators should be able to define progression tiers.

Example:

``
``
``

Each rank can provide:

* Maximum homes
* Maximum spawners
* Spawner upgrade permissions
* Loot multiplier
* Money multiplier
* Special perks

The plugin should integrate with Vault permissions if available.

Do not create a completely separate permission system unless necessary.

---

# 18. PLAYER LIMITS

Configurable limits:

* Maximum homes
* Maximum spawners
* Maximum spawners per mob type
* Maximum spawners per chunk
* Maximum upgrades
* Maximum storage

Limits must support permissions/ranks.

---

# 19. WORLD GROUP ISOLATION

This is CRITICAL.

Every home and spawner action must check the current world/group.

If:

`` → ``

and

`` → ``

then `` settings must NEVER accidentally apply to ``.

Unknown worlds must have the relevant features disabled unless explicitly configured.

World/group checks must apply to:

* Set home
* Teleport home
* Home GUI
* Place spawner
* Break spawner
* Open spawner
* Upgrade spawner
* Collect loot
* Sell loot
* Mob spawning
* Money rewards
* Admin GUI
* Commands
* Scheduled tasks

---

# 20. DATA STORAGE

Use SQLite by default.

Structure the code so MySQL/MariaDB can be added later.

Store:

Players:

* UUID
* Homes
* Progression data

Homes:

* Name
* World
* Group
* Coordinates

Spawners:

* UUID/unique ID
* Owner UUID
* World
* Coordinates
* Mob type
* Level
* Storage
* Upgrade data
* Settings

Never rely only on YAML for frequently changing player/spawner data.

Do database operations asynchronously where safe.

Never block the main server thread unnecessarily.

---

# 21. ADMIN COMMANDS

Create commands such as:

`/plugin reload`

`/plugin give-spawner  `

`/plugin setspawner `

`/plugin remove-spawner`

`/plugin info`

`/plugin debug`

`/plugin group`

Use a proper command structure.

Add tab completion.

Add permission checks.

Do not assume the final command name; make the main command configurable if practical.

---

# 22. ADMIN GUI

Create an admin GUI where administrators can manage:

* World groups
* Home settings
* Spawner types
* Spawner levels
* Loot
* Money rewards
* Limits
* Progression
* Messages

The GUI should modify configuration safely.

Configuration reloads must not wipe player/spawner data.

---

# 23. SECURITY / EXPLOIT PREVENTION

Protect against:

* Item duplication
* Spawner duplication
* Double rewards
* Double loot collection
* Death/reconnect exploits
* GUI click exploits
* Shift-click exploits
* Number-key exploits
* Drag exploits
* Hopper exploits
* Piston exploits
* Explosion duplication
* Chunk unload duplication
* Server restart duplication

Validate all important actions server-side.

Never trust client GUI state.

---

# 24. PERFORMANCE

The plugin must be designed for a large multiplayer server.

Avoid:

* One scheduler per spawner
* Constant database queries
* Excessive entity scanning
* Unnecessary chunk loading
* Blocking database operations
* Repeated configuration reads

Use:

* Cached configuration
* Centralized spawning scheduler
* Efficient collections
* Async database operations where safe
* Proper cleanup when worlds/chunks unload

---

# 25. CONFIGURATION

Do NOT generate a huge pre-filled configuration using my actual server world names.

Use:

``

``

``

``

as documentation placeholders.

I will add the actual values myself.

The configuration must support:

* World → Group mapping
* Group-specific feature settings
* Homes
* Home limits
* Spawners
* Spawner types
* Spawner levels
* Upgrade costs
* Loot
* Money
* Ranks
* Permissions
* GUI
* Messages
* Storage
* Performance settings

---

# 26. IMPORTANT ARCHITECTURE RULE

Create central services such as:

`WorldGroupService`

`HomeService`

`SpawnerService`

`SpawnerUpgradeService`

`SpawnerLootService`

`EconomyService`

`PlayerProgressionService`

`StorageService`

`GuiService`

All gameplay systems must communicate through these services.

Avoid putting the entire plugin inside one Main class.

Use clean separation of responsibility.

---

# 27. FINAL ACCEPTANCE TEST

Before considering the plugin complete, test:

1. Multiple worlds can belong to one group.
2. Different groups have independent settings.
3. Unknown worlds have features disabled.
4. Homes correctly remember their world.
5. Homes survive server restart.
6. Home GUI works.
7. More than 10 spawner types can be configured.
8. Spawner upgrades work.
9. Upgrade costs use Vault.
10. Mob spawning is optimized.
11. Loot is configurable.
12. Money rewards work through Vault.
13. Spawner data survives restart.
14. Spawner data survives chunk unload/load.
15. Spawner duplication is prevented.
16. GUI exploits are prevented.
17. Player limits work.
18. Rank/permission limits work.
19. World/group isolation works everywhere.
20. No Lifesteal functionality is implemented or modified.

Build the plugin as a complete production-ready project, not pseudocode.

Provide complete source code, build files, plugin metadata, documentation, configuration documentation, commands, permissions, and installation instructions.
Kodari AI
KodariSep 30 at 7:22 am 4
HomeSpawnerProgression
A comprehensive Paper/Spigot plugin featuring a world-group-aware home system with GUI, a configurable custom spawner system with 10+ mob types and upgrade tiers, Vault-integrated economy rewards, loot tables, and a rank-based progression system. Central services handle world/group isolation, data persistence via SQLite, and optimized centralized mob spawning. Includes admin commands and GUI for managing groups, spawners, loot, and player limits.
  1. Establish the Paper project, plugin metadata/configuration, SQLite foundation, and centralized world-group service.

  2. Implement persistent homes, permission-based limits, safe teleportation, and a protected paginated GUI.

  3. Implement configurable custom spawners, centralized spawning, upgrades, loot/storage, and optional Vault integration.

  4. Add admin/player commands, permissions, installation/configuration documentation, and final cross-service consistency.

Created the HavenForge Paper/Spigot project with SQLite storage, centralized fail-closed world groups, persistent group-aware homes, protected home/spawner GUIs, configurable custom spawners and levels, Vault-backed upgrades/rewards, admin commands, and installation/configuration documentation. No Lifesteal functionality was added.

Configure world-to-group assignments, enable features for those groups, and define spawner types in config.yml; those features are disabled by default. Spawner types and levels are data-driven, with no hard-coded type list or level cap.

Not included yet: automatic selling, a full rank/progression service and rank-based spawner limits, and an admin GUI for editing every spawner/loot setting—the detailed settings remain YAML-managed. I did not verify the project with a live server or integration test.

Kodari can make mistakes. Review important code before using.
Files

No files in this session

Code