commit 6635f8543e3179bf99d9813905eb55513c83b1d7
Author: Big Pappa <russelburgraymond@gmail.com>
Date:   Thu Sep 3 11:51:07 2026 -0500

    0.1.0 Initial Release

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b91b20b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+# RS-FasterMinecarts
+
+RS-FasterMinecarts is a lightweight Paper plugin that increases the maximum travel speed of minecarts while a player is riding inside them.
+
+The plugin only affects player-occupied minecarts. All other minecarts and entities behave normally.
+
+## Features
+
+- Increase player-occupied minecart speed
+- Configurable speed multiplier
+- Uses the minecart's existing maximum speed as the baseline
+- Automatically restores the original minecart speed when the player exits
+- No commands
+- No permissions
+- No database
+- No impact on server tick rate
+
+## How It Works
+
+When a player enters a minecart, RS-FasterMinecarts:
+
+1. Records the minecart's current maximum speed.
+2. Reads the `max-speed` multiplier from `config.yml`.
+3. Multiplies the minecart's original maximum speed by that value.
+4. Applies the new maximum speed to that minecart.
+
+When the player exits, the original maximum speed is restored.
+
+For example, with `max-speed: 3.0`, a minecart with an original maximum speed of `0.4` will be given a maximum speed of `1.2`.
+
+## Configuration
+
+The default configuration is:
+
+```yaml
+max-speed: 3.0
+```
+
+### max-speed
+
+Controls the speed multiplier applied to player-occupied minecarts.
+
+| Value | Effect |
+|---|---|
+| `1.0` | Normal minecart speed |
+| `2.0` | 2× normal maximum speed |
+| `3.0` | 3× normal maximum speed |
+| `4.0` | 4× normal maximum speed |
+
+## What Is Affected?
+
+### Affected
+
+- Minecarts with a player riding inside
+
+### Not Affected
+
+- Empty minecarts
+- Furnace minecarts
+- Chest minecarts
+- Hopper minecarts
+- TNT minecarts
+- Other minecart variants without a player riding inside
+- Boats
+- Horses
+- Player movement
+- Other entities
+
+## Commands
+
+None.
+
+## Permissions
+
+None.
+
+## Installation
+
+1. Download the RS-FasterMinecarts JAR.
+2. Place the JAR file into your server's `plugins` folder.
+3. Start or restart the server.
+4. Adjust `config.yml` if desired.
+
+## Requirements
+
+- Paper
+- Java 21 or newer
+
+## Version
+
+Current version: **0.1.0**
+
+## Support
+
+For bug reports, feature requests, and support, use the RS Scripting project issue tracker.