SmartSurvivalRPG

SMART SURVIVAL RPG v3.1.0 - CHANGELOG

Release Version: 3.1.0 Platform: Paper / Spigot / Purpur Minecraft Version: 1.20.4 - 1.21+ Java Version: Java 21+ Release Date: May 18, 2026 Update Type: Major Expansion ---

EXECUTIVE SUMMARY

v3.1.0 is the largest expansion in Smart Survival RPG history, transforming the core plugin into a complete survival-horror RPG ecosystem. This update introduces 4 major gameplay systems, 9 apocalypse events, 9 enemy archetypes, 6 survival mechanics, and full multiplayer progression. Focus: Atmosphere, survival tension, cooperation, cinematic gameplay, long-term progression. ---

VERSION STATS

| Metric | Value | |--------|-------| | New Systems | 10 major | | New Features | 45+ | | New Commands | 15+ | | Config Options | 150+ | | Enemy Types | 9 archetypes + biome variants | | Events | 9 cinematic world events | | Survival Meters | 5 (stamina, temperature, thirst, infection, bleeding) | | Medicine Items | 3 (bandage, antibiotic, adrenaline) | | Skills | 6 (mining, farming, combat, survival, woodcutting, fishing) | | Max Skill Level | 50 | | Factions | 3 (Survivors, Military, Scientists) | | Performance | Zero TPS impact at 10+ players | ---

NEW SYSTEMS (PRIORITY ORDER)

SYSTEM 1: BASE BUILDING & DEFENSE

What's New

Bases now have physical durability. Zombies damage structures. Players repair and defend.

Features

- Base marking system: /smartsurvival base-mark to establish base location - Protection zones: 30-block perimeter around base - Structure durability: Walls, gates, doors, watchtowers have health pools - Zombie siege targeting: Hordes prioritize base structures during events - Repair mechanics: Spend materials to heal damaged buildings - Durability HUD: Color-coded warnings (green/yellow/red) - Foundation breaking: Zombies damage foundations first - Perimeter breach detection: Triggers immediate siege escalation

Structure Types & Health

| Structure | Health | Repair Cost | Zombie Dmg/tick | |-----------|--------|-------------|-----------------| | Wood Wall | 100 HP | 5 wood | 5 dmg | | Stone Wall | 250 HP | 10 stone | 3 dmg | | Metal Wall | 500 HP | 10 iron | 1 dmg | | Gate | 150 HP | 8 wood, 2 iron | 4 dmg | | Watchtower | 200 HP | 15 wood, 5 stone | 2 dmg | | Reinforced Door | 100 HP | 6 wood, 2 iron | 6 dmg |

Command

/smartsurvival base-mark - Mark base location
/smartsurvival base-repair - Repair nearby structures

Integration

- Blood Moon events trigger siege at bases with 5+ players - Base durability affects survival pressure - Destroyed bases force player relocation - Base level unlocks better structures ---

SYSTEM 2: FACTION & REPUTATION

What's New

3 factions with reputation progression. Earn reputation through quests, trading, and defense. Unlock faction gear, traders, and perks.

Factions

Survivors (Neutral Focus) - Specialize in shelter, medicine, survival - Exclusive gear: Survivor armor, meds - Unlocks: Hidden bunkers, safe routes - Perks: +20% healing item effectiveness Military (Combat Focus) - Specialize in weapons, ammo, defense - Exclusive gear: Weapons, armor, ammo - Unlocks: Military caches, defense tactics - Perks: +15% damage, +10% armor Scientists (Knowledge Focus) - Specialize in research, tech, survival - Exclusive gear: Radiation suits, tech - Unlocks: Research blueprints, crafting - Perks: +25% crafting yields, research speed

Reputation System

Tiers (0 → 500 points): | Tier | Points | Unlocks | Perks | |------|--------|---------|-------| | Neutral | 0-99 | None | None | | Friendly | 100-249 | Trader access | -10% prices | | Trusted | 250-499 | Faction quests | Exclusive gear, -20% prices | | Allied | 500+ | Faction perks | Full access, events, followers | Reputation Gain: - Completing quests: +25 rep - Trading with faction: +1 rep per 10 gold - Defending faction camps: +50 rep - Surviving events near camps: +10 rep

NPC Traders

- Location: Faction camps scattered across world (configurable) - Buy: Loot, resources, crafted items - Sell: Faction gear, medicine, ammo, unique items - Currency: Gold ingots (configurable) - Prices: Scale with reputation (Allied = 30% discount)

Commands

/smartsurvival faction-rep <player> - View reputation
/smartsurvival faction-rep <player> add <amount> - Admin control

---

SYSTEM 3: VEHICLE SYSTEM

What's New

3 vehicle types for fast travel. Fuel-based, configurable speed, cargo support.

Vehicle Types

Cart (Slow Transport) - Seats: 2 players - Speed: 5 m/s - Fuel: 1 coal per 100 blocks - Durability: 150 HP - Cargo: No - Cost: 20 wood + 10 iron + 5 leather Motorcycle (Medium Transport) - Seats: 1 player - Speed: 10 m/s - Fuel: 2 coal per 100 blocks - Durability: 100 HP - Cargo: No - Cost: 15 iron + 8 redstone + 4 leather Truck (Heavy Transport) - Seats: 4 players - Speed: 3 m/s - Fuel: 1 coal per 50 blocks - Durability: 300 HP - Cargo: 128 slots (2x inventory) - Cost: 30 iron + 15 wood + 10 redstone + 8 leather

Mechanics

- Durability: Zombies damage vehicles (reduces speed if critical) - Fuel tracking: Real-time fuel depletion - Passenger sharing: Travel together, shared location - Cargo system: Trucks carry additional inventory - Destruction: Destroyed vehicles drop cargo + 50% crafting materials - Repair: Similar to base structures

Commands

/smartsurvival vehicle <type> - Spawn vehicle (Admin only)
/smartsurvival vehicle info - Check vehicle status

---

SYSTEM 4: RADIATION ZONES

What's New

Wasteland areas emit harmful radiation. Radiation suits required for survival. Geiger counter audio feedback.

Mechanics

- Radiation zones: Pre-defined wasteland areas (config) - Intensity levels: 0.5 (1 heart per 10s) to 1.0 (1 heart per 5s) - Protection: Radiation suit (15 iron + 10 leather + 5 gold, 500 durability) - Visual effects: Screen distortion, nausea, slowness - Audio: Geiger counter intensifies as proximity increases - Contaminated water: Poison damage if drunk without suit - Sickness: 5-10 second debuff after leaving zone (lingering damage)

Zone Configuration

radiation-zones:
  wasteland-alpha:
    center: [100, 64, 200]
    radius: 150
    intensity: 0.5 # hearts per second damage
  wasteland-beta:
    center: [400, 64, -200]
    radius: 200
    intensity: 1.0

Loot Opportunity

- High-radiation zones have rare loot (risk/reward) - Zombie spawners concentrated in wasteland - Hidden bunkers (radiation-protected) contain legendary gear ---

APOCALYPSE EVENTS (9 TOTAL)

EVENT 1: BLOOD MOON (5-PHASE CINEMATIC EVENT)

Multi-Phase Structure

Phase 1: Warning (Duration: 60s) - Sky turns blood red - Distant screams (audio) - Zombies become agitated - Particles: Red fog, ground corruption - Action: Prepare, gather, take shelter - Difficulty: Ramping Phase 2: Rising Fear (Duration: 90s) - Fog spreads across world - Visibility reduced to 30 blocks - Horde assembly (zombies gathering) - Tremor sounds (ground shaking) - Particles: Purple/red corruption spreads - Difficulty: High tension Phase 3: Horde Assault (Duration: 240s, 4 waves) - Coordinated zombie waves - Wave count: 5 + (playerCount * 5) per wave - Damage scaling: +25% per wave - Boss spawning: 1 per 4 players - Heartbeat panic effects - Difficulty: Extreme Phase 4: Elite Mutation (Duration: 120s) - Mutant zombie spawns - Boss abilities: Area attacks, summons - Poison nova, corruption spreads faster - Epic music - Difficulty: Climactic Phase 5: Dawn Survival (Duration: 60s) - Hordes thin out - First light appears - Victory music (if survived) - XP rewards: Massive (5000-10000 XP per player) - Loot drops: Legendary gear guaranteed -