SharedSoulSurvival – Experience True Team Survival

What if every heart, every bite, every drop of XP was shared among your entire team?

SharedSoulSurvival redefines Minecraft multiplayer by turning your friends into your lifeline. When one falls, all fall. When one thrives, everyone rises.

🔥 The Ultimate Cooperative Challenge

🪨 Shared Health

• If one player gets hurt, everyone feels it.
• Healing? It heals all.
• Say goodbye to lone wolves — survival is a shared journey now.

🍗 Shared Hunger & Saturation

• Eating helps everyone.
• Starving? Now it’s a group concern.
• Promotes resource sharing and planning like never before.

🎒 Unified Inventory

• One inventory for all players.
• Drop an item? Everyone sees it disappear.
• Shared gear, shared tools, shared responsibility.

✨ Shared XP & Level Progression

• Earn XP together, level up together.
• Enchanting costs are paid from a team XP pool.
• Mob grinding becomes a team sport.

🏆 Synchronized Advancements

• Unlock an advancement? Everyone gets it.
• No one falls behind — your journey is shared in every achievement.
• Stay aligned, celebrate every milestone as a team.

💀 Shared Death

• One death = total wipe.
• A dramatic message warns the team:
  "[Player] has died! All souls fall together..."
• Raises the stakes for every encounter.

🧪 Potion Effects for All

• Drink one potion, everyone gets the effect.
• Plan buffs and debuffs with intention.
• Potion use becomes a strategic decision for the whole team.

---

🔧 Tech Stuff (But Still Cool)

📊 PlaceholderAPI Support

Display live stats with 10+ custom placeholders:

• %sharedsoul_health% – Shared HP
• %sharedsoul_hunger% – Shared Hunger
• %sharedsoul_level% – Shared XP Level
• %sharedsoul_deaths% – Total Team Deaths
• %sharedsoul_player_count% – Online Players
• %sharedsoul_inventory_size% – Inventory Size
• And more!

🟔️ SQLite Database

• Tracks deaths persistently.
• No extra setup — it's plug & play.

⚙️ Performance Built-In

• Optimized sync cycle (100ms).
• Designed for up to 20 players.
• Efficient and lightweight (<1MB)!

🎨 Clean Console Integration

• ASCII art welcome message 🖼️
• Debug mode for devs
• Professional logging and error handling

---

🎯 Perfect For...

• 👥 Close-knit friends wanting real teamwork
• 🎥 Streamers creating high-stakes moments
• 🧙 Roleplay servers with a shared fate
• 🏆 Hardcore survivalists looking for the next big challenge
• 🛠️ Team-building events and creative gameplay

---

📋 Requirements

• Minecraft 1.18.2+
• Java 11+ (Java 17+ recommended)
• Spigot, Paper, or compatible forks
• [Optional] PlaceholderAPI for scoreboard support
• 4–6 GB RAM recommended
• 2-core CPU minimum

---

🚀 How to Install

1. Drop the plugin into /plugins/
2. Restart your server
3. (Optional) Install PlaceholderAPI
4. Customize config.yml if needed
5. Survive... together

---

🎮 Commands & Permissions

Command	Description
/soulreload	Reloads plugin config

Permission	Who gets it?
sharedsoul.admin	Admins (default: OP)

---

📊 Scoreboard Examples

TAB Plugin:

scoreboard:
  title: "&c&lShared Soul Survival"
  lines:
    - "&fHealth: &c❤ %sharedsoul_health%/20"
    - "&fHunger: &6🍗 %sharedsoul_hunger%/20"
    - "&fLevel: &b⬆ %sharedsoul_level%"
    - "&fDeaths: &4☠ %sharedsoul_deaths%"
    - "&fPlayers: &a%sharedsoul_player_count% online"
    - "&fInventory Slots: &e%sharedsoul_inventory_size%"

FeatherBoard:

boards:
  sharedsoul:
    title: "&c&lShared Soul"
    lines:
      - "&fShared Health: &c%sharedsoul_health%"
      - "&fShared Hunger: &6%sharedsoul_hunger%"
      - "&fLevel: &b%sharedsoul_level%"
      - "&fTotal Deaths: &4%sharedsoul_deaths%"
      - "&fPlayers Online: &a%sharedsoul_player_count%"
      - "&fInventory Slots: &e%sharedsoul_inventory_size%"

---

🎩 Example Gameplay Scenarios

🛡️ The Siege

Your base is under attack. One player takes a hit? Everyone bleeds. Team coordination becomes the only way to survive.

🔥 The Lava Drop

A player slips into lava... and the whole team dies. Now you’re rethinking who leads the mining trip.

🐍 The Cave Spider

One player is poisoned, and now everyone is feeling sick. Better stock up on milk!

---

⚠️ A Few Warnings

• This plugin is hard — not recommended for casual players.
• Full cooperation required: no lone survivors.
• Always back up your world before using.
• Test on a dev server before going live.

---

🛠️ Simple Configuration

# Debug mode for advanced logging
debug: false

---

📊 Plugin Stats

Feature	Detail
Size	<1MB
Sync Delay	~100ms
Storage	Local SQLite
Player Limit	Optimized for 1–20
Compatibility	Works with most plugins

---

🧰 PlaceholderAPI Integration

Easily integrate with any PlaceholderAPI-supported plugin — full docs provided!

---

📷 Screenshots You’ll Want to Show Off

1. Console Startup
   Clean ASCII art and version info.

2. Shared Health in Action
   One takes damage, all take damage.

3. Group Death Broadcast
   Shared fate, dramatic messaging.

4. Real-Time Scoreboard
   Fully dynamic placeholders in action.

5. Unified Inventory
   Items sync instantly across players.

---

🎥 Video Ideas

• How to Install (2–3 min)
• Gameplay Showcase (5–7 min)
• PlaceholderAPI Integration Guide (3–4 min)

---

🚑 Need Help?

• Installation guide included
• PlaceholderAPI instructions available
• Troubleshooting tips in docs
• Ongoing updates and bug fixes

---

🏆 Why Use SharedSoulSurvival?

• 🧠 Gameplay you’ve never experienced before
• 🛠️ Polished, professional quality
• 🔧 Easy to set up and use
• 💬 Full scoreboard/PlaceholderAPI integration
• 📈 Actively developed — always getting better
• 💯 Totally free!

---

📅 Version Info

v1.2.0 – Initial release

• All core systems
• Full PlaceholderAPI support
• Optimized for performance
• Extensive documentation

---

🛠️ What’s Next?

• Shared sync Configurable
• Configurable sync delays
• Multi-world support
• More placeholders!

---

Ready to survive together — or die together?
Download SharedSoulSurvival and find out what true teamwork means.

Join our community for support, updates, and feature suggestions: https://discord.gg/U3CSJYmWNS