NusaNeo is a comprehensive Elemental Skyblock experience plugin that transforms your Minecraft server into an immersive RPG-style adventure. Players control elemental powers, build and upgrade islands, complete quests, and interact with NPCs in a progression-based game mode.
Key Features
️ Island System
- Custom Island Creation: Players can create personal or team islands
- Island Leveling: Progress system based on island development
- Protection System: Customizable island permissions and visitor settings
- Team Management: Invite players, set roles, and manage island members
⚡ Elemental System
- Multiple Elements: Choose from various elements with unique abilities
- Progression System: Gain elemental XP and level up
- Elemental Abilities: Unlock and use powerful abilities as you level
- Ability Binding: Configure your hotbar with preferred abilities
Quest System
- Multi-Objective Quests: Complex quests with multiple goals
- Time-Based Quests: Daily, weekly, weekend and event quests
- Dialogue System: Engaging NPC interactions
- Flexible Rewards: XP, items, money, elemental XP
- Custom Conditions: Element types, player level, location requirements
- Completion Actions: Messages, sounds, effects, tags
♂️ NPC Integration
- Quest NPCs: Talk to NPCs to start and complete quests
- Custom Dialogue: Create engaging storylines
- Interactive Elements: NPCs that respond to player progress
MythicMobs Integration
- Special Mob Quests: Hunt mythic creatures for rewards
- Boss Battles: Weekend and special boss events
- Themed Encounters: Custom encounters tied to elements
Admin Tools
- Island Management: Admin commands for island oversight
- Quest Editing: In-game quest management
- Configuration: Extensive config options
- Economy Integration: Works with Vault-compatible economy plugins
Requirements
- Server running Spigot/Paper 1.20+
- Required Dependencies:
- Recommended Dependencies:
- Citizens (for NPCs)
- MythicMobs (for custom mobs)
- PlaceholderAPI (for placeholders)
- ProtocolLib (for advanced features)
Installation
- Download the plugin and place in your server's plugins folder
- Install required dependencies (Vault)
- Install recommended dependencies for full functionality:
- Citizens for NPC functionality
- MythicMobs for custom mob integration
- PlaceholderAPI for stats integration
- ProtocolLib for visual effects
- Restart your server
- Configuration files will be created in the plugins/NusaNeo/ folder
- Customize the plugin to your liking via the configuration files
⚙️ Configuration
The plugin creates several configuration files:
- config.yml- Main plugin settings
- messages.yml - All plugin messages (fully customizable)
- elements.yml - Configure elemental powers and progression
- quest/ - Directory containing all quest configurations
Creating Custom Quests
Quests are defined in YAML files in the
quests/ directory. Example:
Code (Text):
daily_mining:
name: "Daily Mining Challenge"
description: "Mine ores for rewards!"
npc_id: 3
repeatable: true
schedule_type: DAILY
reset_hour: 4
objectives:
mine_copper:
description: "Mine 16 Copper Ore"
type: "BREAK_BLOCK"
target_amount: 16
data:
material: "COPPER_ORE"
rewards:
xp: 250
money: 500
items: "IRON_INGOT:5,COPPER_INGOT:10"
and for dialogues :
Code (Text):
guide_greeting:
name: Guide Greeting
npc_id: 1
start_line: welcome
priority: 100
requirements:
forbidden_tags:
- started_quest_island_guide_quest
lines:
welcome:
text: Welcome to NusaNeo! I'm your island guide. This magical realm needs your
help!
actions:
- TAG:add:met_guide
responses:
Tell me about this island: about_island
I'd like to start my journey: quest_offer
Goodbye for now: goodbye
about_island:
text: NusaNeo is a realm of elemental magic. You'll build your island, master
an element, and become powerful.
responses:
Tell me more about elements: about_elements
I'd like to ask about something else: welcome
about_elements:
text: The four elements grant unique abilities. Fire brings destruction and
power, Water offers healing and flexibility, Earth provides protection and
stability, while Air delivers speed and evasion.
responses:
I understand: welcome
quest_offer:
text: I have some tasks that will help you get started in this world. Are you
ready to begin?
actions:
- QUEST:offer:island_guide_quest
responses:
I'll take the quest: quest_accept
Not right now: welcome
quest_accept:
text: Excellent! First, you'll need to gather some basic resources. Collect
5 oak logs and 3 stone, then talk to the Resource Manager.
actions:
- QUEST:start:island_guide_quest
- QUEST:stage:island_guide_quest:1
- TAG:add:started_quest_island_guide_quest
responses:
I'll get right on it: goodbye
goodbye:
text: Good luck on your adventures! Come back when you need guidance.
guide_in_progress:
name: Quest In Progress
npc_id: 1
start_line: progress_check
priority: 50
requirements:
required_tags:
- started_quest_island_guide_quest
forbidden_tags:
- quest_island_guide_quest_stage_3
- quest_island_guide_quest_stage_4
- completed_quest_island_guide_quest
lines:
progress_check:
text: How's your gathering going? Remember, we need 5 oak logs and 3 stone.
responses:
I'm still working on it: gathering_tips
Where can I find the Resource Manager?: resource_manager_location
I'll get back to it: goodbye_progress
gathering_tips:
text: You can find oak trees all around the spawn area. For stone, you'll need
to mine some using a pickaxe.
responses:
Thanks for the help: goodbye_progress
resource_manager_location:
text: The Resource Manager is just down the path to the east. Look for the building
with the crafting table sign.
responses:
I'll head there after gathering: goodbye_progress
goodbye_progress:
text: Good luck with your gathering! I'll be here when you're ready to continue.
guide_final_stage:
name: Final Quest Stage
npc_id: 1
start_line: welcome_back
priority: 80
requirements:
required_tags:
- quest_island_guide_quest_stage_3
forbidden_tags:
- completed_quest_island_guide_quest
lines:
welcome_back:
text: Ah, you're back! I see you've spoken with the Resource Manager. You've
done well gathering the materials.
actions:
- QUEST:stage:island_guide_quest:4
responses:
I've completed all the tasks: complete_quest
complete_quest:
text: Excellent work! These resources will help you begin building your own
island. Here are some tools to help you on your journey.
actions:
- QUEST:complete:island_guide_quest
responses:
Thank you for your help: next_steps
next_steps:
text: Your next step should be to choose an elemental path. Each offers unique
abilities. You can speak with the Elemental Master when you're ready.
responses:
I'll do that next: goodbye_final
goodbye_final:
text: May the elements guide your path! Come back if you need any more advice.
guide_post_quest:
name: Post-Quest Dialogue
npc_id: 1
start_line: post_quest_greeting
priority: 20
requirements:
required_tags:
- completed_quest_island_guide_quest
lines:
post_quest_greeting:
text: ${random:How are you progressing with your island?|Have you chosen your
elemental path yet?|Your journey is just beginning, but you're off to a great
start!|The Resource Manager mentioned you showed great potential.}
responses:
I have more questions: post_quest_questions
Just saying hello: post_quest_goodbye
post_quest_questions:
text: What would you like to know about?
responses:
Tell me about elements again: about_elements
How do I build my island?: island_building
Where do I find more quests?: more_quests
island_building:
text: To build your island, use the /neo island create command. This will create
a skyblock island for you where you can build your base.
responses:
Thanks for the information: post_quest_goodbye
more_quests:
text: You can find more quests by exploring the world and talking to NPCs. The
Elemental Master, Merchant, and Farmer all have tasks for newcomers.
responses:
I'll seek them out: post_quest_goodbye
post_quest_goodbye:
text: ${random:Best of luck on your journey!|May the elements favor you!|Your
island will be magnificent, I'm certain of it!|Until we meet again, adventurer!}
Commands & Permissions
Main Commands
- /neo - Main plugin command
- /neo help - Show help menu
- /neo reload - Reload plugin configurations
- /neo element - Manage elements
- /neo ability - Manage abilities
- /neo island - Island management commands
- /neo journal - Open quest journal
Island Commands
- /neo island create - Create a new island
- /neo island home - Teleport to your island
- /neo island invite <player> - Invite a player
- /neo island settings - Manage island settings
Admin Commands
- /neo isadmin - Island admin commands
- /neo isadmin tp <player> - Teleport to player's island
- /neo isadmin reset <player> - Reset player's island
- /neo isadmin forcedelete <player> - Delete an island
PlaceholderAPI Integration
NusaNeo offers PlaceholderAPI placeholders for displaying:
- %nusaneo_element% - Player's current element
- %nusaneo_element_level% - Player's element level
- %nusaneo_element_xp% - Player's element XP
- %nusaneo_island_level% - Island level
- %nusaneo_island_members% - Island member count
- %nusaneo_active_quests% - Number of active quests
Permissions
Getting Started Guide
- First Steps: Players start by talking to the guide NPC
- Island Creation: Players create their first island
- Element Selection: Players choose their elemental path
- Quest Progression: Begin the tutorial quests
- Skill Development: Level up elements and unlock abilities
- Island Growth: Invite friends and expand the island
Updates
Regular updates and new features are planned, including:
- New elements and abilities
- Expanded quest system
- Additional island upgrades
- New mythic bosses
- Custom biomes and structures