Raithe Shackles — Player Imprisonment & Tracking Mod

Inspired by Novacain's ShackleGear, Raithe Shackles enables player-run justice: capture opponents, move them to cells, and maintain custody using a single, fuel-driven item—no admin intervention required.

What is a Shackle?

A Shackle is a binding device that, once charged, will imprison the next Seraph (player) you slay while carrying an empty Shackle. The prisoner remains bound to that Shackle until its fuel expires or the Shackle is broken.

Prisoners temporarily receive a restricted role (default: suvisitor) and cannot fight, build, or break blocks until freed. (This role is stored and returned upon freeing. Admins will gain admin status back)

How It Works In-Game

Crafting a Shackle

Assemble one using:

• 4x Gold Ingots

• 1x Temporal Gear

• 4x Plain Glass Blocks

Charging the Shackle

A Shackle must be fueled before it can imprison anyone.

1. Put any coal in your hotbar: Charcoal, Brown Coal, Black Coal, Coke, or Anthacite. (Server Configurable)

2. Hold the Shackle in your main hand.

3. Right-Click to feed coal into it.

4. Repeat until you reach the required charge (typical servers require a full day of fuel; value is Server Configurable).

Tip: You can refuel a held Shackle later.

Imprisonment Trigger

• Carry a charged, empty Shackle on your person (inventory or hotbar).

• Kill a player.

• The Shackle activates and imprisons that player, storing their identity and original spawn.

The Shackle then consumes fuel over time. If the timer hits zero, the prisoner is freed automatically.

While Imprisoned

• Prisoners are assigned the (Server Configurable) suvisitor role (no combat, building, or block breaking).

• The Shackle’s location is tracked by the server—whether it’s in your inventory or hidden in a chest.

• Prisoners see a continuous particle stream pointing toward the Shackle.

  • Colors shift from cool (far) to warm (near) to indicate proximity.

Freeing a Prisoner

A prisoner is released if any of the following occur:

• Fuel expires (Shackle timer runs out).

• The Shackle is dropped on the ground (logging out while holding it causes a drop)

Important: Breaking or dropping a Shackle immediately frees the prisoner. Handle it carefully.

Cell Teleport (Beds)

You can bind a prisoner to a “cell” and move them there.

• Hold the Shackle and Sneak + Right-Click a Bed to teleport the prisoner to that bed and set their spawn.

• Cost: 2x Rusty Gears (server configurable).

• Cooldown: 24 in-game hours between cell teleports.

• The Shackle records the cell position and can move the prisoner there again after cooldown.

Player Tools & Commands

• Who last fueled my Shackle?

  • Prisoners can request a fuel log to reveal the last fueler of the Shackle that currently holds them.

  • /sg fuellog

• Admin/Moderator tools

  • Force-imprison a target while holding a charged Shackle.

  • Force-free a prisoner when necessary.

  • /sg admin [shackle/free] [playername]

Server Configuration Options

Server owners can tune balance and behavior via config:

• Fuel Math

  • Minimum burn temperature for valid fuels

  • Fuel duration multiplier

  • Maximum storable time in a Shackle

  • Minimum charge required to imprison

• Roles & Permissions

  • The restricted role assigned while imprisoned (default: suvisitor)

• Cell Teleport

  • Cost item & amount (default: 2x Rusty Gears)

  • Cooldown between cell teleports (default: 24 in-game hours)

These options allow servers to scale Shackles from light RP tools to serious custody mechanics on PvP/Civ servers.

In-Game Guide

Raithe Shackles includes a native Vintage Story Guidebook entry, accessible via the standard help system. The guide covers:

• Crafting recipe and fueling

• Imprisonment rules & freeing conditions

• Cell teleport usage and cooldown

• How prisoners follow the particle trail back to the Shackle

Integrations & Compatibility

• Designed for PvP, Civ-style, and RP servers

• Works alongside base container mechanics—Shackles can be hidden or transferred, but the prisoner’s trail keeps pointing to them

• Not really meant for servers with land claims due to shackles being unobtainable by intruders, use at your own risk with land claims.

Use Cases

• Bounty hunting and POW exchanges

• City-state justice and jail systems

• High-stakes PvP: ransom, rescue, and counter-raids

• RP scenarios that need reliable custody without admin presence

Enjoying Raithe Shackles? Check out my other mod:

Raithe Snitches

If you’d like to support development and future updates, consider buying me a coffee on Ko-Fi. Your support helps keep the mod growing and maintained!

https://ko-fi.com/raithe_vs

“Better a blade at your back than a chain on your wrist.”