README.md

# TerminatorPlus [BETA]

**This project is on pause indefinitely. Updates are not guaranteed. Please do not use in a production server.**

Additionally, the readme and wiki may be outdated.

![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge&logo=java&logoColor=white)
![GitHub](https://img.shields.io/github/languages/code-size/HorseNuggets/TerminatorPlus?color=cyan&label=Size&labelColor=000000&logo=GitHub&style=for-the-badge)
![GitHub](https://img.shields.io/github/license/HorseNuggets/TerminatorPlus?color=violet&logo=GitHub&labelColor=000000&style=for-the-badge)
![Discord](https://img.shields.io/discord/357333217340162069?color=5865F2&label=Discord&logo=Discord&labelColor=23272a&style=for-the-badge)

**TerminatorPlus** is a bukkit (paper) plugin that allows the creation of server-side player bots. Unlike many NPC
plugins that already exist, this project has an emphasis on making the bots as human-like as possible.

### Download

Releases are currently available on our Discord server, which can be found [here](https://discord.gg/vZVSf2D6mz). You
can also find them on the [releases page](https://github.com/HorseNuggets/TerminatorPlus/releases)

### Machine Learning

TerminatorPlus currently utilizes classic population-based reinforcement learning for bot PVP training. Q-learning is a work in progress, along with variable A* pathfinding.

### API Support

Built API artifacts are available on the [releases page](https://github.com/HorseNuggets/TerminatorPlus/releases), and
the Discord server.
See
the [API Module](https://github.com/HorseNuggets/TerminatorPlus/tree/master/TerminatorPlus-API/src/main/java/net/nuggetmc/tplus/api)
for available methods.

Example:
```java
Terminator terminator = TerminatorPlusAPI.getBotManager().createBot(location, "BotName", skin, skinSignature);
```

### Version Support

This plugin requires [Paper 1.21.1](https://papermc.io/downloads/all).

### Future Updates

This project is in a very early stage, and we have many more ideas to tackle.
- [ ] Individual agents assigned per bot
- [ ] A GUI to view currently loaded bots and cool data with them
- [ ] AI data saved to the plugin data folder, able to be loaded into bots
- [ ] Saving config data in memory

## License

This project is licensed under [Eclipse Public License](https://github.com/batchprogrammer314/player-ai/blob/master/LICENSE).
beta moment 2021-08-25 17:57:25 -05:00			`# TerminatorPlus [BETA]`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
Update README 2024-03-15 16:41:50 -04:00			`This project is on pause indefinitely. Updates are not guaranteed. Please do not use in a production server.`
Update README.md 2023-11-21 13:52:33 -05:00
			`Additionally, the readme and wiki may be outdated.`

Stylize the readme cuz why not 👀 2021-08-24 15:46:44 +01:00			`![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge&logo=java&logoColor=white)`
			`![GitHub](https://img.shields.io/github/languages/code-size/HorseNuggets/TerminatorPlus?color=cyan&label=Size&labelColor=000000&logo=GitHub&style=for-the-badge)`
			`![GitHub](https://img.shields.io/github/license/HorseNuggets/TerminatorPlus?color=violet&logo=GitHub&labelColor=000000&style=for-the-badge)`
			`![Discord](https://img.shields.io/discord/357333217340162069?color=5865F2&label=Discord&logo=Discord&labelColor=23272a&style=for-the-badge)`

Update README 2024-03-15 16:41:50 -04:00			`TerminatorPlus is a bukkit (paper) plugin that allows the creation of server-side player bots. Unlike many NPC`
			`plugins that already exist, this project has an emphasis on making the bots as human-like as possible.`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00			`### Download`

Update README 2024-03-15 16:41:50 -04:00			`Releases are currently available on our Discord server, which can be found [here](https://discord.gg/vZVSf2D6mz). You`
			`can also find them on the [releases page](https://github.com/HorseNuggets/TerminatorPlus/releases)`
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00
			`### Machine Learning`

			`TerminatorPlus currently utilizes classic population-based reinforcement learning for bot PVP training. Q-learning is a work in progress, along with variable A* pathfinding.`

			`### API Support`

Update README 2024-03-15 16:41:50 -04:00			`Built API artifacts are available on the [releases page](https://github.com/HorseNuggets/TerminatorPlus/releases), and`
			`the Discord server.`
			`See`
			`the [API Module](https://github.com/HorseNuggets/TerminatorPlus/tree/master/TerminatorPlus-API/src/main/java/net/nuggetmc/tplus/api)`
			`for available methods.`
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00
Update README 2024-03-15 16:41:50 -04:00			`Example:`
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00			```java
Update README 2024-03-15 16:41:50 -04:00			`Terminator terminator = TerminatorPlusAPI.getBotManager().createBot(location, "BotName", skin, skinSignature);`
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00			```

			`### Version Support`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
Updated gradle from 7.4 to latest (8.11.1) + required build.gradle.kts changes Updated minecraft version from 1.20.4 to 1.21.1. Updated java from 17 to 21. Bumped up version from 4.4.0-BETA to 4.5.0-BETA. Added damageSource to botDeathEvent as it is now required for 1.21. Added boolean (false) to comonListenerCookie.createInitial as this is now required. Updated addEntityPacket method to take all required arguments. Updated overridden setListener method to setListenerForServerboundHandshake as it seems this is the new method required (needs to be tested). Updated imports to use org.bukkit.craftbukkit instead of org.bukkit.craftbukkit .v1_20_r3 (it seems craftbukkit updated and versioning is not required anymore). 2024-11-30 13:43:15 +01:00			`This plugin requires [Paper 1.21.1](https://papermc.io/downloads/all).`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00			`### Future Updates`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
sheeeeesh 🥵 2021-08-23 02:24:32 -05:00			`This project is in a very early stage, and we have many more ideas to tackle.`
sheeeeesh 🥵🥵🥵🥵🥵 2021-08-23 02:25:39 -05:00			`- [ ] Individual agents assigned per bot`
			`- [ ] A GUI to view currently loaded bots and cool data with them`
			`- [ ] AI data saved to the plugin data folder, able to be loaded into bots`
			`- [ ] Saving config data in memory`
forgot to add readme in the previous push 2021-06-27 00:27:48 -05:00
			`## License`

Update README.md 2021-08-21 13:48:04 -05:00			`This project is licensed under [Eclipse Public License](https://github.com/batchprogrammer314/player-ai/blob/master/LICENSE).`