TwinsControl

TwinsControl is a modern, lightweight, and fully configurable cheat inspection (screenshare / freeze) plugin built for Minecraft servers running on Paper, Purpur, Spigot, and Pufferfish from version 1.16.5 up to 1.21.x+.

It allows server staff to securely freeze suspected cheaters, teleport them to a dedicated control room, monitor inspection duration via live BossBar and ActionBar timers, and manage confessions or combat-log penalties automatically.

---

Features

• Full Player Lockdown:

  • Frozen players can look around but cannot move, sprint, jump, or sneak.
  • Interacting with blocks, opening containers, picking up items, and dropping items are strictly blocked.
  • Complete invulnerability: Inspected players cannot take damage or attack other entities.

• Real-Time BossBar & ActionBar Timers:

  • Live duration counter showing how long the inspection has been active.
  • Keeps both the player and the staff informed throughout the entire check.

• Interactive Confession System (/confess):

  • Suspects can admit to cheating using /confess (or /itiraf).
  • Alerts online staff members instantly with sound cues and broadcast messages.
  • Optionally triggers automatic reduced penalty commands (e.g., shorter ban duration).

• Combat-Log & Quit Punishments:

  • Automatically executes configurable console commands if a player disconnects or tries to evade an active inspection.

• Smart Return Teleportation:

  • Saves the player's exact coordinates prior to inspection.
  • Automatically restores them back to their initial location once cleared (/finishcontrol).

• Audio & Visual Effects:

  • Configurable blindness potion effect during inspection.
  • On-screen Title and Subtitle notifications with configurable fade/stay timings.
  • Sound effects for inspection start, completion, and staff notifications.

• HEX Colors & MiniMessage:

  • Full support for MiniMessage formatting, gradients (<gradient:#B499DD:#A66AFF>), and standard HEX color codes (&#RRGGBB).

• Multi-Language Support (lang/ folder):

  • Ships with ready-to-use English (messages_en.yml) and Turkish (messages_tr.yml) language files.
  • Every single message, title, and actionbar string is 100% translatable.

• Zero NMS Dependencies:

  • Developed using standard Bukkit/Spigot APIs with relocated Adventure libraries, ensuring high compatibility and future-proof performance.

---

Commands & Permissions

Staff Commands (twinscontrol.staff)

Command	Aliases	Description
/control <player>	/kontrol, /tc, /twinscontrol	Freezes and teleports the suspect to the inspection room
/finishcontrol <player>	/kontrolbitir, /endcontrol	Concludes the inspection and teleports the player back
/control list	/kontrol list, /kontrol liste	Shows all players currently under inspection and active timers
/setcontrol	/setkontrol	Sets the inspection spawn point at your current position
/control reload	/kontrol reload	Reloads config.yml and language files

Player Commands

Command	Aliases	Description
/confess	/itiraf	Allows a frozen player to admit to cheating

---

Configuration Preview

Configuration is straightforward via config.yml:

# Active language file located in the lang/ directory ("en", "tr", or custom)
language: "en"

# Automatically teleport player back to their initial location when finished
teleport-back-on-finish: true

# Status effects applied during control
effects:
  blindness:
    enabled: true
    amplifier: 1

# Live BossBar timer
bossbar:
  enabled: true
  color: RED
  style: SOLID

# Confession settings
confession:
  auto-punish: false
  punish-commands:
    - "tempban %player% 3d Admitted Cheating (Reduced)"

# Punishments for quitting during inspection
punishments:
  quit-punishment:
    enabled: true
    commands:
      - "ban %player% Evading cheat inspection"