Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -112,3 +112,6 @@ buildNumber.properties

# Common working directory
run/

# Docker server plugins directory
plugins/
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ MyTrip is a Spigot plugin that adds drugs to Minecraft. Players can craft custom
## Dependencies

- **Spigot API**: 1.21.4-R0.1-SNAPSHOT
- **CrucialLib** (plugin.yml softdepend: `CrucialAPI`): v3.0.0 β€” provides custom items (`CrucialItem`), GUI pages, localization, JSON I/O, and visual effects
- **CrucialLib** (plugin.yml softdepend: `CrucialLib`): v3.0.1 β€” provides custom items (`CrucialItem`), GUI pages, localization, JSON I/O, and visual effects
- **Java**: 21
- **Gson** (transitive via CrucialLib): JSON serialization for drug/tool/player data

Expand All @@ -19,7 +19,7 @@ mvn test # Run unit tests
mvn clean verify # Full build + test cycle
```

Output JAR: `target/MyTrip-v0.8.0.jar`
Output JAR: `target/MyTrip-v0.8.1.jar`

## Project Structure

Expand Down
73 changes: 54 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,63 @@
[![User Wiki](https://img.shields.io/badge/Wiki-Users-blue)](https://github.com/ChafficPlugins/MyTrip/wiki) [![Download](https://img.shields.io/badge/Download-v0.7.0-red)](https://github.com/ChafficPlugins/MyTrip/releases/latest) [![Discord](https://img.shields.io/badge/Discord-Join-blue)](https://discord.gg/RYFamQzkcB)
[![User Wiki](https://img.shields.io/badge/Wiki-Users-blue)](https://chafficplugins.github.io/docs/mytrip/) [![](https://jitpack.io/v/ChafficPlugins/MyTrip.svg)](https://jitpack.io/#ChafficPlugins/MyTrip) [![Discord](https://img.shields.io/badge/Discord-Join-blue)](https://discord.gg/RYFamQzkcB)

# MyTrip

MyTrip is a Spigot plugin that adds drugs to the world of Minecraft. It is developed by ChafficPlugins since 04/01/2020 and is open-source since 04/19/2021.
MyTrip is a Spigot/Paper plugin that adds drugs to the world of Minecraft. Players can craft custom substances, consume them for potion effects, develop addictions, and overdose. Developed by ChafficPlugins since April 2020 and open-source since April 2021.

# Summary
## Features

1. [Contributing](#contributing-to-mytrip)
2. [Dependencies](#dependencies)
- **Custom Drugs** β€” Create unlimited drugs with custom recipes, potion effects, overdose thresholds, and addiction probabilities
- **Drug Set** β€” A portable crafting station exclusively for drug crafting
- **Addiction System** β€” Players develop addictions with escalating intensity (1-8), causing periodic damage and negative effects
- **Overdose** β€” Configurable overdose threshold and effects per drug
- **Drug Test** β€” Test whether a player has drugs in their system
- **Anti-Toxin** β€” Consumable item that removes all drug effects
- **5 Default Drugs** β€” Weed, Cocaine, LSD, Heroin, and Ecstasy come pre-configured with recipes and effects
- **Developer API** β€” Event-based API for other plugins to hook into drug actions
- **Permissions** β€” Fine-grained permission nodes for every action

# Contributing to MyTrip
1. Create a Fork
2. Load the repository into your IDE
3. Open a Pull-Request
4. Allow edits from maintainers
5. Done! Create pull request and await a review by one of the maintainers
## Requirements

# Dependencies
| Requirement | Version |
|---|---|
| Java | 21+ |
| Server | Spigot, Paper, or compatible fork 1.21+ |
| [CrucialLib](https://github.com/ChafficPlugins/CrucialLib) | v3.0.1+ |

This project requires Java 16+.
All dependencies are managed automatically by Maven.
## Quick Start

* Spigot
* Version: 1.18-R0.1-SNAPSHOT
* CrucialAPI
* Version: 2.1.5
* [GitHub](https://github.com/Chafficui/CrucialAPI)
1. Download [CrucialLib v3.0.1+](https://github.com/ChafficPlugins/CrucialLib/releases) and place it in `plugins/`
2. Download [MyTrip](https://github.com/ChafficPlugins/MyTrip/releases/latest) and place it in `plugins/`
3. Restart the server
4. Use `/mt list` to see the 5 default drugs, or `/mt create <name>` to create your own

See the [full documentation](https://chafficplugins.github.io/docs/mytrip/) for detailed setup, configuration, and usage.

## Contributing

1. Fork the repository
2. Create a feature branch
3. Open a Pull Request and allow edits from maintainers
4. Await review from a maintainer

## Dependencies

All dependencies are managed by Maven.

| Dependency | Version | Purpose |
|---|---|---|
| [Paper API](https://papermc.io/) | 1.21.4-R0.1-SNAPSHOT | Server API |
| [CrucialLib](https://github.com/ChafficPlugins/CrucialLib) | v3.0.1 | Custom items, GUI, localization, JSON I/O |

## Building

```bash
mvn clean package # Build the plugin JAR
mvn test # Run tests (395 tests)
```

Output: `target/MyTrip-v0.8.1.jar`

## License

[GPL-3.0](LICENSE)
Loading