✅ Apocalipsis — Documentation

Apocalipsis is a complete survival-series plugin for Paper 1.21+ built to turn your server into a real apocalyptic progression experience with global states, disasters, daily missions, ranks, skills, narrative events, and a progressive onboarding tutorial for new players.

Requirements

• Paper 1.21+ (recommended)
  
  
• Java 21

(Optional soft-depends)

• WorldGuard
  
  
• ProtectionStones

⚡ Quick Start (Installation)

1. Place Apocalipsis-<version>.jar inside your server: plugins/
   
   
2. Start the server once (configs will generate automatically)
   
   
3. Go to: plugins/Apocalipsis/ and edit YAML files
   
   
4. Restart the server
   
   
5. Open the main menu with: /menu

✅ Admins / Host:

• Start apocalypse systems: /avo start
  
  
• Start a new day cycle: /avo newday

Configuration Files
All configuration files are generated inside:

plugins/Apocalipsis/

Main files:

• config.yml
  
  
• desastres.yml
  
  
• eventos.yml
  
  
• misiones_new.yml
  
  
• rangos.yml
  
  
• rewards/recompensas.yml
  
  
• skills.yml
  
  
• tutorial.yml
  
  
• evasiones.yml
  
  
• protecciones.yml
  
  
• stream_features.yml
  
  
• rangos_permanentes.yml
  
  
• navidad.yml

Persistent data files:

• mission_data.yml
  
  
• skill_data.yml
  
  
• tutorial_*.yml
  
  
• state.yml

Main Systems
️ Disasters Cycle

• Preparation → Active states
  
  
• Single BossBar UI with countdown + status
  
  
• Safe Mode system to prevent lag during low TPS
  
  
• Cooldowns, minimum players, safe pause & anti-rebound logic
  
  
• Progressive difficulty integration for new players

Narrative Events (Manual)

• Only one event can be active at a time
  
  
• No automatic cycle (controlled by host/admin)
  
  
• Examples: Ember Echo, Shadow Echo, Christmas, Path to the End

Daily Missions + Ranks

• Missions catalog filtered by rank & difficulty
  
  
• Daily assignment controlled by “new day” system
  
  
• Punishments applied for failed missions (only if player was active)
  
  
• Rewards claim system + survival points
  
  
• Permanent ranks + stream features support

Skills / Abilities Tree

• Skills purchase & upgrades using XP
  
  
• Toggleable abilities, cooldowns, persistence
  
  
• GUI menus included
  
  
• Includes multiple QoL systems: Backpack, Portable EnderChest, Waypoint, Summons

Tutorial / Onboarding (Progressive Difficulty)

• New players receive a guided onboarding experience
  
  
• 0–4 hour phases with multipliers (damage / frequency)
  
  
• Temporary buffs, tips, actionbar guidance
  
  
• Epic milestones, buddy system, and player metrics

⌨️ Commands
Main command:

• /avo <subcommand>
  Aliases: /apocalipsis, /avoc, /apoc

Player commands:

• /menu → Open main menu
  
  
• /habilidades → Open skills tree menu
  
  
• /toggle <ability> → Enable/disable abilities
  
  
• /recompensa → Open pending rewards menu
  
  
• /mochila → Open virtual backpack
  
  
• /echest → Open portable ender chest
  
  
• /waypoint [set] → Set/teleport to personal waypoint
  
  
• /coords → Show current coordinates
  
  
• /invocar <entity> → Summon allied entity
  
  
• /carta → Send a written letter to Santa (seasonal)
  
  
• /misionestuto → View onboarding/tutorial progress

Admin-only:

• /cartas → View all sent letters

Tutorial:

• /tutorial progreso|reset|fase|stats
  Aliases: /tut, /guia

Permissions

• avo.user → Basic commands (default: true)
  
  
• avo.admin → Full access (default: OP)
  
  
• apocalipsis.tutorial.user → Tutorial commands (default: true)
  
  
• apocalipsis.tutorial.admin → Tutorial administration (default: OP)

️ Support / Bugs
If you find any bug or want to suggest improvements:

• Use the Spigot Discussion tab
  
  
• Or open a GitHub Issue: https://github.com/OliveerFr/Apocalipsis-1.21

Good luck surviving… and welcome to Apocalipsis.