https://github.com/ptthanh02/celestcombat

A robust combat logging plugin designed for the CelestinalSMP server, compatible with Minecraft versions 1.21 - 1.21.5
https://github.com/ptthanh02/celestcombat

folia-supported minecraft-plugin paper

Last synced: about 2 months ago
JSON representation

A robust combat logging plugin designed for the CelestinalSMP server, compatible with Minecraft versions 1.21 - 1.21.5

• Host: GitHub
• URL: https://github.com/ptthanh02/celestcombat
• Owner: ptthanh02
• Created: 2025-03-22T02:52:24.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-29T13:06:13.000Z (about 1 year ago)
• Last Synced: 2025-05-29T14:30:31.668Z (about 1 year ago)
• Topics: folia-supported, minecraft-plugin, paper
• Language: Java
• Homepage: https://modrinth.com/plugin/celest-combat-plugin
• Size: 275 KB
• Stars: 1
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

          
# CelestCombat

[![Modrinth Downloads](https://img.shields.io/modrinth/dt/celest-combat-plugin?logo=modrinth&logoColor=white&label=downloads&labelColor=%23139549&color=%2318c25f)](https://modrinth.com/plugin/celest-combat-plugin)

[![Spigot Downloads](https://img.shields.io/spiget/downloads/123515?logo=spigotmc&logoColor=white&label=spigot%20downloads&labelColor=%23ED8106&color=%23FF994C)](https://www.spigotmc.org/resources/celest-combat-combat-log-%E2%9C%A8-1-21-1-21-4-%EF%B8%8F.123515/)

[![Folia](https://img.shields.io/badge/Folia-Supported-brightgreen.svg?logo=papermc&logoColor=white&labelColor=%23139549&color=%2318c25f)](https://github.com/PaperMC/Folia)

[![Modrinth](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/modrinth_vector.svg)](https://modrinth.com/plugin/celest-combat-plugin)

[![Spigot](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/spigot_vector.svg)](https://www.spigotmc.org/resources/celest-combat-combat-log-%E2%9C%A8-1-21-1-21-4-%EF%B8%8F.123515/)

[![Hangar](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/hangar_vector.svg)](https://hangar.papermc.io/Nighter/CelestCombat)

A comprehensive combat management plugin for Minecraft servers specializing in PvP environments.

## Requirements

- **Minecraft Version:** 1.21 - 1.21.4

- **Server Software:** Paper, Purpur, Folia

- **Java Version:** 21+

### Optional Dependencies

- **WorldGuard** - For safe zone integration and region protection

- **GriefPrevention** - For claim-based protection systems

## Installation

1. Download the latest release from [Modrinth](https://modrinth.com/plugin/celest-combat-plugin)

2. Place the `.jar` file in your server's `plugins` folder

3. Restart your server

4. Configure the plugin in `plugins/CelestCombat/config.yml`

5. Reload with `/cc reload`

## Commands

| Command | Permission | Description |

|---------|------------|-------------|

| `/cc help` | `celestcombat.command.use` | Display command help |

| `/cc reload` | `celestcombat.command.use` | Reload plugin configuration |

| `/cc tag  [player2]` | `celestcombat.command.use` | Manually tag players in combat |

| `/cc removetag ` | `celestcombat.command.use` | Remove combat tags |

**Aliases:** `/cc`, `/combat`, `/celestcombat`

## Permissions

| Permission | Default | Description |

|------------|---------|-------------|

| `celestcombat.command.use` | OP | Access to all plugin commands |

| `celestcombat.update.notify` | OP | Receive update notifications |

| `celestcombat.bypass.tag` | false | Bypass combat tagging |

## Building

```bash

git clone https://github.com/ptthanh02/CelestCombat.git

cd CelestCombat

./gradlew build

```

The compiled JAR will be available in `build/libs/`

## Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Test thoroughly

5. Submit a pull request

## Support

- **Issues & Bug Reports:** [GitHub Issues](https://github.com/ptthanh02/CelestCombat/issues)

- **Discord Community:** [Join our Discord](https://discord.com/invite/FJN7hJKPyb)

## Statistics

[![bStats](https://bstats.org/signatures/bukkit/CelestCombat.svg)](https://bstats.org/plugin/bukkit/CelestCombat/25387)

## License

This project is licensed under the CC BY-NC-SA 4.0 License - see the [LICENSE](LICENSE) file for details.