CodellaPlaytime | [1.16-1.21] | MADE WITH CODELLA AI

DISCLAIMER: THIS PLUGIN WAS MADE USING CODELLA IN 2 MINUTES. IT'S AN ADVANCED AI FOR MINECRAFT PLUGINS. https://codella.ai

An advanced playtime tracking plugin for Spigot/Paper servers. It monitors how long players are active, when they are AFK, and offers a fully configurable rewards system to keep your community engaged.

Features

Detailed Playtime Tracking: Automatically tracks every player's time on the server and separates it into three categories: Total, Active, and AFK.
Automatic & Manual AFK: Players can use the `/afk` command to toggle their status, or the server can automatically mark them as AFK after a configurable period of inactivity.
Playtime Leaderboards: Display server-wide leaderboards for total, active, or AFK playtime to foster friendly competition.
Configurable Rewards: Reward your players for their dedication! Create unlimited playtime rewards that players can claim through a simple GUI menu (`/rewards`). Rewards can execute any command, such as giving items, money, or permissions.
PlaceholderAPI Support: Integrates seamlessly with PlaceholderAPI to display player stats anywhere you want, using placeholders like `%codellaplaytime_active%`.
Highly Configurable: Customize the AFK timer, all messages, and the entire rewards system (items, commands, descriptions) directly from the `config.yml` file.
Fine-Grained Permissions: Control access to every feature, including checking other players' time, viewing leaderboards, and using the AFK command.

Commands & Permissions

| /playtime | Checks your own playtime statistics. | codellaplaytime.playtime |
| /playtime [player] | Checks another player's playtime. | codellaplaytime.playtime.others |
| /playtime top [active/afk/total] | Shows the playtime leaderboard. | codellaplaytime.leaderboard |
| /afk | Toggles your AFK status on or off. | codellaplaytime.afk |
| /rewards | Opens the playtime rewards menu. | codellaplaytime.rewards |

Configuration

CodellaPlaytime comes with a powerful `config.yml` that allows for deep customization.

config.yml
This file controls the core features, messages, and rewards.

# CodellaPlaytime Configuration

# The time in seconds of inactivity before a player is automatically set to AFK.
# Set to 0 to disable automatic AFK.
afk-timer: 300

# Settings for messages
messages:
  prefix: "&8[&6Playtime&8] &r"
  afk_on: "&7You are now AFK."
  afk_off: "&7You are no longer AFK."
  playtime_self:
    - "&6Your Playtime Stats:"
    - " &eTotal: &f%codellaplaytime_total%"
    - " &aActive: &f%codellaplaytime_active%"
    - " &cAFK: &f%codellaplaytime_afk%"
  playtime_other:
    - "&6%player%'s Playtime Stats:"
    - " &eTotal: &f%codellaplaytime_total%"
    - " &aActive: &f%codellaplaytime_active%"
    - " &cAFK: &f%codellaplaytime_afk%"
  leaderboard_header: "&6&lPlaytime Leaderboard (%type%)"
  leaderboard_entry: "&e#%rank%. &f%player% - &7%time%"
  player_not_found: "&cPlayer not found."
  invalid_command: "&cInvalid command usage."
  reward_claimed: "&aYou have claimed the %reward_name%&a reward!"
  reward_already_claimed: "&cYou have already claimed this reward."
  reward_not_unlocked: "&cYou have not unlocked this reward yet."

# Playtime Rewards
# Players can claim rewards based on their ACTIVE playtime.
# 'time': Required active playtime in minutes.
# 'name': Display name in the rewards menu (use color codes!).
# 'item': Material of the item in the menu.
# 'description': A short description of the reward contents.
# 'commands': Console commands executed when claimed. Use %player% for the player's name.
rewards:
  '10min':
    time: 10
    name: "&e&lTier I Reward"
    item: "IRON_INGOT"
    description:
      - "&7You will receive:"
      - "&f- 1 Diamond"
      - "&f- $100"
    commands:
      - "give %player% diamond 1"
      - "eco give %player% 100"
  '30min':
    time: 30
    name: "&6&lTier II Reward"
    item: "GOLD_INGOT"
    description:
      - "&7You will receive:"
      - "&f- 5 Diamonds"
      - "&f- $500"
    commands:
      - "give %player% diamond 5"
      - "eco give %player% 500"

Dependencies

PlaceholderAPI: Required for using placeholders.

Installation

1. Download the latest version of CodellaPlaytime.
2. Install PlaceholderAPI if you haven't already.
3. Place the `CodellaPlaytime.jar` file into your server's `plugins` folder.
4. Restart your server.
5. Configure the `config.yml` file in the `plugins/CodellaPlaytime` directory.
6. Run `/papi ecloud download CodellaPlaytime` and `/papi reload` to enable the placeholders.