MOONWILL V1 – COMPLETE MASTER DEVELOPMENT PROMPT
- PROJECT IDENTITY
- Plugin Name: MoonWill
- Version: V1.0.0
- Minecraft Software: Paper
- Minecraft Version: 1.21.11
- Java Version: Java 21
- Build System: Maven
- Database: SQLite
- Server Type: SMP
- Target: 100+ concurrent players
- Edition: Java Edition
IMPORTANT:
Build a complete, functional Minecraft plugin. Do not create a concept document, pseudocode, or incomplete project. All features must work together.
- MAIN CONCEPT
MoonWill is a supernatural Will-based SMP plugin.
Every player receives one random Will represented by a physical Minecraft item.
Players can use their Will's special abilities, steal other players' Wills through PvP kills, and obtain new Wills using a craftable Will Giver.
There are 10 unique Wills in V1.
- START WILL SYSTEM
Command: "/startwill"
When a player executes this command:
- Check whether the player has already received a Will.
- If not, begin the Will selection animation.
- Levitate the player approximately 5 blocks above the ground.
- Surround the player with approximately 1,000 particles.
- Create rotating particle circles and magical particle effects.
- Play cinematic sound effects.
- Randomly select one of the 10 Wills.
- Display a dramatic title:
YOUR WILL IS CHOSEN
- Display the selected Will's name.
- Give the player their physical Will item.
- Save their Will permanently in SQLite.
The animation must look smooth and impressive without causing server lag.
Prevent players from using "/startwill" repeatedly to obtain unlimited Wills.
- ALL 10 WILLS
Implement these 10 unique Wills.
- Will of Strength
- Increased attack damage.
- Strength ability.
- Defensive power ability.
- Will of Speed
- Speed ability.
- Quick movement burst.
- Dash ability.
- Will of Lightning
- Lightning-based attack.
- Electric burst ability.
- Lightning movement ability.
- Will of Flux
- Energy manipulation.
- Short-range teleport ability.
- Flux energy burst.
- Will of Fire
- Fire-based attack.
- Flame burst.
- Fire resistance ability.
- Will of Water
- Water projectile.
- Defensive water shield.
- Water movement ability.
- Will of Nature
- Vine-based attack.
- Nature shield.
- Temporarily root enemies.
- Will of Shadow
- Short invisibility ability.
- Shadow dash.
- Darkness burst.
- Will of Light
- Light beam attack.
- Flash ability.
- Radiant shield.
- Will of Ice
- Ice projectile.
- Frost shield.
- Temporarily slow enemies.
IMPORTANT:
Every Will must have distinct abilities, effects, particles, sounds, cooldowns, and visual identity.
Balance all abilities for SMP PvP. Avoid permanent stun, infinite invisibility, or excessively powerful attacks.
- PHYSICAL WILL ITEM SYSTEM
Every Will must be represented by a unique physical Minecraft item.
Requirements:
- Unique display names.
- Custom item descriptions (lore).
- Different item materials or custom model data.
- Unique particles when activated.
- Correct item identification using PersistentDataContainer.
- Prevent item duplication exploits.
- Prevent players from creating fake Will items through anvils or renaming.
The physical item must be connected to the actual Will stored in the database.
- WILL STEALING SYSTEM
This is one of the main features.
When Player A kills Player B:
- Check whether Player B owns a Will.
- Remove Player B's current Will.
- Transfer the Will to Player A.
- Update both players' SQLite records.
- Give Player A the physical Will item.
- Display a kill announcement.
Example:
MOONWILL
Player A has stolen Player B's Will of Lightning!
The transfer must be atomic and protected against duplication, disconnects, and simultaneous PvP events.
Add configuration options for Will stealing.
- WILL GIVER SYSTEM
Create a special craftable item called:
WILL GIVER
It allows a player to obtain a new random Will.
Create a configurable crafting recipe using:
- Nether Star
- Echo Shard
- Diamond Blocks
- Ender Pearls
- Other configurable ingredients if required.
When used:
- Validate the item.
- Check the player's current Will.
- Start the Will selection animation.
- Randomly select a new Will.
- Replace the previous Will.
- Give the new physical Will item.
- Save the result in SQLite.
Do not allow recipe or item duplication exploits.
- WILL ABILITY SYSTEM
Each Will must have:
- Passive ability.
- Active ability.
- Unique visual effects.
- Unique activation sound.
- Individual cooldown.
- Configurable ability values.
Use configurable activation controls and commands.
Make the abilities easy to use on both normal Java controls and supported server-side Bedrock players where applicable.
- COMMANDS
Implement:
- "/startwill" – Start initial Will selection.
- "/will" – View current Will.
- "/will info" – View Will information and abilities.
- "/will give <player> <will>" – Admin gives a Will.
- "/will remove <player>" – Remove a player's Will.
- "/will reload" – Reload configuration.
- "/will list" – List all available Wills.
Add proper permission checks and tab completion.
- DATABASE
Use SQLite.
Save:
- Player UUID.
- Player's current Will.
- Will ownership.
- Will item data where necessary.
- Ability cooldowns where necessary.
- Player selection status.
- Relevant transfer history.
Data must survive server restarts.
- CONFIGURATION
Provide a complete config.yml containing:
- Enable/disable individual Wills.
- Will selection animation settings.
- Particle settings.
- Sound settings.
- Cooldowns.
- Ability damage.
- Will stealing settings.
- Will Giver recipe.
- Item customization.
- Messages.
- Admin permissions.
All important values should be configurable without modifying Java source code.
- PERFORMANCE AND SECURITY
- Support Paper 1.21.11.
- Use Java 21.
- Optimize particle animations.
- Never block the main server thread with database operations.
- Prevent item duplication.
- Prevent fake Will items.
- Prevent cooldown bypasses.
- Handle player disconnects during animations.
- Handle server restarts safely.
- Avoid unnecessary repeating tasks.
- Ensure compatibility with other normal SMP plugins.
Target smooth performance with 100+ concurrent players.
- PROJECT STRUCTURE
Create a proper Maven project.
Include:
- Main plugin class.
- Will manager.
- Will ability manager.
- Will selection animation manager.
- Particle manager.
- Will stealing listener.
- Will item manager.
- Will Giver crafting system.
- SQLite database manager.
- Command manager.
- Configuration manager.
- Event listeners.
- plugin.yml.
- config.yml.
- README.md.
- pom.xml.
Use clean object-oriented Java architecture.
- DEVELOPMENT REQUIREMENTS
Develop the complete plugin in clearly organized phases.
For every phase:
- Provide actual Java source files.
- Implement working functionality.
- Compile using Maven.
- Fix compilation errors.
- Test compatibility with Paper 1.21.11.
- Preserve previously completed features.
- Never replace working functionality with placeholders.
- Do not claim something works unless it has been implemented and tested.
At completion, provide:
- Complete Maven source project.
- Compiled MoonWill-V1.0.0.jar.
- Installation instructions.
- Configuration documentation.
- Complete command and permission list.
- Testing report.
FINAL INSTRUCTION:
Build MoonWill V1 as a complete, polished, production-quality Will Steal SMP plugin. All 10 Wills must be functional, physical Will items must work correctly, and the entire system must be integrated. Do not silently remove or simplify requested features.