MekaCameras - Camera and Monitor Plugin for Minecraft
Version: 2.0.22 (Based on API 1.19.4 - 1.20.1+)

Description
MekaCameras is an innovative plugin for Spigot/Paper Minecraft servers that allows players to create and manage surveillance systems with cameras and monitors. Immerse yourself in a unique "astral projection" experience to remotely view your cameras, while your body remains safe in its original location. Manage your cameras through intuitive GUIs, define construction limits, and customize the experience with multi-language support.

Features

• Customizable Cameras and Monitors: Create camera and monitor items with configurable materials.
  
  
• Astral Projection: When using a monitor, your player enters spectator mode and is teleported to the camera, while an "astral body" (ArmorStand) appears at your original location.
  
  
• Camera Navigation: Switch between active cameras using the spacebar (next) and SHIFT (previous) while in a camera session.
  
  
• Intuitive GUIs:
  • Monitor Management GUI: Manage which cameras are active for a specific monitor and set the monitor's privacy (public/private).
    
    
  • Camera Settings GUI: Activate or deactivate cameras individually.
• Construction Limits: Define camera and monitor limits per player, with configurable bonuses via permissions and commands.
  
  
• Multi-Language Support: The plugin comes with support for several languages (Portuguese, English, Spanish, French, German, Russian, Simplified Chinese) and allows for easy addition of new languages.
  
  
• Simplified Removal: Remove cameras and monitors with Shift + Punch or via a command.
  
  
• Region Protection: Basic integration to respect region protection plugins when attempting to place cameras/monitors.
  
  
• Exit Cooldown: A small cooldown is applied when exiting a camera session to prevent spam.
  
  
• Astral Body Interaction: Attacking or interacting with the astral body ends the camera session and applies a cooldown.

Installation

1. Download the MekaCameras.jar file from the SpigotMC page.
   
   
2. Place the .jar file in your Minecraft server's plugins/ folder.
   
   
3. Restart or reload your server.
   
   
4. The plugin will automatically generate the configuration files (config.yml) and language files in the plugins/MekaCameras/lang/ folder.

Commands
All commands start with /mekacameras or its aliases (/mcameras, /mc, /mcamera).

• /mcameras give <camera/monitor> <player> <amount>
  • Description: Gives a camera or monitor item to a player.
    
    
  • Example: /mcameras give camera Caputinado 1
    
    
  • Permission: mekacameras.admin (or be OP)
• /mcameras addlimit <camera/monitor/both> <player> <amount>
  • Description: Adds a bonus to a player's camera/monitor limit. Use -1 to set the limit as unlimited.
    
    
  • Example: /mcameras addlimit camera Caputinado 5 (adds 5 to camera limit)
    
    
  • Example: /mcameras addlimit both Caputinado -1 (sets unlimited limits for both)
    
    
  • Permission: mekacameras.admin (or be OP)
• /mcameras remove
  • Description: Removes the camera or monitor you are looking at.
    
    
  • Permission: mekacameras.admin (or be OP) or be the display owner.
• /mcameras language <language_code>
  • Description: Changes the plugin's language. Available language codes can be seen in the error if you type an invalid one (e.g., pt_br, en, es).
    
    
  • Example: /mcameras language en
    
    
  • Permission: mekacameras.admin (or be OP)
• /mcameras reload
  • Description: Reloads the plugin configuration and language messages.
    
    
  • Permission: mekacameras.admin (or be OP)

Permissions

• mekacameras.admin
  • Description: Grants access to all MekaCameras administration commands.
    
    
  • Default: op
• mekacameras.limit.camera.<value>
  • Description: Adds a bonus to the camera limit a player can own. Replace <value> with a number (e.g., 10 for +10 cameras) or -1 for unlimited.
    
    
  • Example: mekacameras.limit.camera.5 (player can have 5 more cameras than the base limit)
    
    
  • Example: mekacameras.limit.camera.-1 (player has unlimited cameras)
    
    
  • Default: false
• mekacameras.limit.monitor.<value>
  • Description: Adds a bonus to the monitor limit a player can own. Works the same way as the camera permission.
    
    
  • Default: false
• mekacameras.limit.both.<value>
  • Description: Adds a bonus to the limits of both cameras and monitors. Works the same way as individual permissions.
    
    
  • Default: false

Configuration (config.yml)
This file is automatically generated on the first plugin run and allows you to customize MekaCameras' behavior.

# MekaCameras Configuration
# This file will be automatically generated on the first plugin run.

# Default plugin language.
# Language files are located in the 'lang' folder of the plugin.
# Examples: pt_br, en, es, fr, de, ru, zh_cn
language: "pt_br"

# Item settings
# Define the material for camera and monitor items.
# Use valid Minecraft material names (e.g., IRON_INGOT, COPPER_INGOT, DIAMOND).
# A complete list can be found at: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
camera-item-material: "IRON_INGOT"
monitor-item-material: "COPPER_INGOT"

# Camera and monitor limits per player.
# Set -1 for no limit.
max-cameras-per-player: -1
max-monitors-per-player: -1

# Section for cameras and monitors (will be populated by the plugin)
displays: {}

Explanation of Options:

• language: Defines the plugin's default language. Ensure that the corresponding language file exists in the plugins/MekaCameras/lang/ folder.
  
  
• camera-item-material: Defines the material of the item that will represent the camera in-game. Use valid Minecraft material names.
  
  
• monitor-item-material: Defines the material of the item that will represent the monitor in-game. Use valid Minecraft material names.
  
  
• max-cameras-per-player: Defines the maximum number of cameras a player can have. Set to -1 for no limit.
  
  
• max-monitors-per-player: Defines the maximum number of monitors a player can have. Set to -1 for no limit.
  
  
• displays: This section is automatically populated by the plugin and stores data for cameras and monitors placed in the world. Do not edit it manually.

How to Use

1. Obtaining Items: Use the command /mcameras give <camera/monitor> <your_name> 1 to obtain a camera or monitor item.
   
   
2. Placing Cameras/Monitors:
   • Hold the camera or monitor item in your hand.
     
     
   • Right-click on a block where you want the camera/monitor to be attached. The plugin will attempt to attach it to the clicked block's face (ground, ceiling, wall).
     
     
   • An invisible barrier will be placed at the location, and the camera/monitor display will appear.
3. Using a Monitor:
   • Right-click on a monitor you own (or that is public).
     
     
   • You will be teleported to the first active camera linked to this monitor and enter spectator mode. Your astral body will appear at your original location.
4. Managing a Monitor (GUI):
   • Left-click on a monitor you own.
     
     
   • A GUI will open, showing all cameras you own.
     
     
   • Click on the camera items to activate/deactivate their linkage to this monitor.
     
     
   • Use the privacy button (hopper) to toggle between public and private monitor.
5. Managing a Camera (GUI):
   • Left-click on a camera you own.
     
     
   • A simple GUI will open, allowing you to activate or deactivate the camera. Deactivated cameras will not appear in monitor lists.
6. Navigating between Cameras (in session):
   • While in a camera session (spectator mode):
     • Press SPACE (jump) to go to the next active camera.
       
       
     • Press SHIFT (sneak) to go to the previous active camera.
7. Exiting Camera Session:
   • Left-click (punch) anywhere.
     
     
   • You will be teleported back to your astral body's location.
     
     
   • Your astral body (ArmorStand) can also be attacked or interacted with by you or other players to end your session. This will apply a cooldown.
8. Removing Cameras/Monitors:
   • Look directly at the invisible barrier of the camera/monitor.
     
     
   • Press SHIFT + Punch (left-click).
     
     
   • Alternatively, use the /mcameras remove command while looking at it.
     
     
   • The item will be returned to your inventory (if not in creative mode).