# PointsThing Plugin

A customizable player points system for Minecraft servers. This plugin tracks and awards points to players for kills, with special bonuses based on the victim's armor and enchantments.

## Features

- Award points to players for kills
- Armor-based point bonuses (configurable multipliers for different armor types)
- Enchantment-based point bonuses
- Leaderboard system
- PlaceholderAPI integration
- Configurable messages and settings
- Optional point reset on death

## Why I'm Releasing This

I'm releasing this plugin publicly because FlashSurvival.net never paid me for my work on it and subsequently blocked me and permanently banned me from their server(s).

## Version Compatibility

This plugin was developed for Minecraft 1.19.3 but should work on newer versions (1.20.x+) without modification. The plugin uses standard Bukkit/Spigot API methods that remain stable across updates. If you encounter any issues with newer versions, simply recompiling the plugin against the newer server version should resolve them.

## Configuration

The plugin is highly customizable via the config.yml file. You can adjust:

- Base points for kills
- Armor type multipliers
- Enchantment bonuses
- Auto-save intervals
- Leaderboard settings
- Messages and formatting

## Commands

- `/points` - Check your current points
- `/points <player>` - Check another player's points
- `/leaderboard` - View the points leaderboard
- `/armorbonus` - Calculate armor bonus for yourself
- `/armorbonus <player>` - Calculate armor bonus for another player
- `/clearpoints` - Admin command to clear all points
- `/pointsreload` - Reload the configuration

## Placeholders

When PlaceholderAPI is installed, the following placeholders are available:

- `%points_amount%` - Player's points
- `%points_rank%` - Player's rank on the leaderboard
- `%points_armor_value%` - Player's current armor bonus value
- `%points_kill_value%` - Total points for killing the player
- `%points_top_X_name%` - Name of the player at position X on the leaderboard
- `%points_top_X_points%` - Points of the player at position X on the leaderboard

## Installation

1. Place the jar file in your plugins folder
2. Restart your server
3. Edit the configuration as needed
4. Use `/pointsreload` to apply changes

## Support

If you run into any problems or have questions about the plugin, join the Discord server for assistance:
https://discord.gg/4fvAj7XY9B