Soul Possession

Soul Possession is a multifunctional survival and multiplayer mod that adds a deep and engaging mechanic of separating the soul from the body. Become a spirit, possess friends or enemies, share control over their body in a unique partnership, and even jump from one host to another in an exciting display of power. This mod is built from the ground up for reliable operation, carefully handling player disconnections and server restarts so your ghostly adventures are never unfairly interrupted.

Core Features

Become a Spirit: Use the mystical Soul Crystal to separate your soul from your body. Your physical form and inventory will be safely stored in a "Dormant Body" right where you left it. As a spirit, you are invulnerable, can fly, and are visually represented as a transparent, ghostly version of yourself with soul particle effects.

Possess Other Players: As a spirit, you receive a Soul Apple. Convince another player to eat it, and you will instantly take control of their body, gaining access to their health, hunger, inventory, and actions. The original player (the Host) does not disappear—they become a spectator, forced to watch their own body being controlled by you!

The Switch! A Unique Cooperative Mechanic: This is where things get interesting. While possessing a host, the possessor can press a key (default 'T') to return control of the body to the host. The possessor then becomes the spectator. This can be switched back and forth at any time, allowing for incredible strategic and cooperative (or chaotic!) gameplay mechanics.

Return to Your Body: When you finish your astral journey, simply press the return key (default 'R'). After a short 3-second countdown, you will be transported back to your own Dormant Body, ending the possession and freeing the host.

Advanced Body Hopping: For a truly powerful soul, a special enchanted Chorus Fruit allows you to "hop" from your current host directly to a new, unsuspecting target. This frees your original host and establishes a new possession, making you a terrifying and unpredictable phantom.

Full Immersion:

• Custom Visuals: Spirits are transparent and glow, with custom soul particles.
• Screen Overlays: As a possessor controlling the body, you will see a subtle purple vignette. As a host being controlled, you will see a red one.
• Custom Sounds: Unique sound effects for becoming a spirit, possessing a player, switching control, and returning to your body.
• Prefixed Chat: Your chat messages automatically receive a [Soul] or [Host] prefix to avoid confusion during possession.

Server-Friendly and Robust:

• All possession data and dormant bodies are saved and survive server restarts.
• Intelligent handling of player logouts. If a possessor disconnects, the host regains control until they return. If a host disconnects, the possessor is forced to return to their body.
• Powerful admin commands (/forcepossess, /forceunpossess, /bodyhop) to manage any situation.

How to Begin Your Astral Journey

1. Craft a Soul Crystal. This is your key to the spirit world.
2. Use the Soul Crystal. Right-click while holding it. Your body will become dormant, and your soul will be freed. You will receive a Soul Apple imbued with your essence.
3. Find a Host. Give the Soul Apple to another player. Once they eat it, the possession begins!
4. Explore the Possibilities: You now control their body. Press 'T' to return control to them, and 'R' to begin the process of returning to your own body.

The Rules of Possession

Possessor (Soul):

• Has a Dormant Body somewhere in the world containing their original self.
• Can initiate a "Switch" of control with the Host by pressing 'T'.
• Can initiate a "Return" to their Dormant Body by pressing 'R'.
• Can use a Body Hop item to jump to a new Host.

Host:

• Is the original owner of the possessed body.
• Is a spectator when the Possessor is in control.
• Gains control of their own body when the Possessor "Switches" control to them.
• Is completely freed when the Possessor "Returns" or "Body Hops" away.

For Server Administrators

This mod includes a set of commands to ensure you have full control over possessions on your server.

• /forcepossess : Forces one player to possess another.
• /forceunpossess : Ends a possession involving the specified player, returning the soul to their body.
• /bodyhop : (When used by an admin as a possessor) Hops to the new target.
• /givesoulitems: Gives the admin a Soul Crystal and other related test items.
• /soulreturn and /switchcontrol: Can also be run as commands.

This mod adds a completely new level of player interaction in Minecraft. Will you be a benevolent spirit, helping a friend out of a tight spot? Or a mischievous poltergeist, causing chaos and "borrowing" bodies at will? The choice is yours.