{"id":27000154,"url":"https://github.com/kalbarczykdev/easyroads","last_synced_at":"2025-04-04T03:19:03.657Z","repository":{"id":253655906,"uuid":"844099141","full_name":"KalbarczykDev/EasyRoads","owner":"KalbarczykDev","description":"🛤️ EasyRoads is a Minecraft Bukkit plugin that enhances player movement by modifying their speed based on their location on predefined roads. This plugin allows server administrators to create custom roads with specific speed attributes.","archived":false,"fork":false,"pushed_at":"2024-08-23T11:39:59.000Z","size":36,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-22T05:51:15.066Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KalbarczykDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-18T11:35:46.000Z","updated_at":"2024-09-19T13:18:12.000Z","dependencies_parsed_at":"2024-08-18T15:26:30.733Z","dependency_job_id":"272f741b-b5e9-4283-9237-b08fdd76e0f9","html_url":"https://github.com/KalbarczykDev/EasyRoads","commit_stats":null,"previous_names":["okdotdev/easyroads","oslint/easyroads","kalbarczykdev/easyroads"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KalbarczykDev%2FEasyRoads","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KalbarczykDev%2FEasyRoads/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KalbarczykDev%2FEasyRoads/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KalbarczykDev%2FEasyRoads/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KalbarczykDev","download_url":"https://codeload.github.com/KalbarczykDev/EasyRoads/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247113052,"owners_count":20885660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-04T03:19:03.134Z","updated_at":"2025-04-04T03:19:03.652Z","avatar_url":"https://github.com/KalbarczykDev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EasyRoads 🛤️\n\n**EasyRoads** is a Minecraft Bukkit plugin that enhances player movement by modifying their speed based on their location on predefined roads. This plugin allows server administrators to create custom roads with specific speed attributes.\n\n## Table of Contents 📚\n- [Features](#features)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Commands](#commands)\n- [Permissions](#permissions)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [License](#license)\n\n\n\n## Features ✨\n\n- Define roads with specific speeds and blocks.\n- Adjust player and entity movement speeds based on their location on roads.\n- Reload configuration and list roads via in-game commands.\n\n## Installation 📥\n\n1. Download the latest version of EasyRoads from the releases section.\n2. Place the `EasyRoads.jar` file into your server's `plugins` directory.\n3. Restart or reload your server to enable the plugin.\n\n## Configuration ⚙️\n\nThe plugin uses a configuration file located in `plugins/EasyRoads/config.yml`. Key settings include:\n\n- `speedIncreaseRate`: Rate at which the speed increases when on a road.\n- `speedDecayRate`: Rate at which the speed decreases when off a road.\n- `messages`: Customizable messages for various plugin actions.\n- `roads`: Define roads with their respective speed and block types.\n- `affectedEntities`: List of entity types affected by the road speeds.\n\n## Example configuration:\n\n```yaml\n# This is the main configuration file for the plugin\n# You can add more roads by adding more road names\n# and blocks to the list of blocks for each road\n\n# maximum acceleration per tick\nspeedIncreaseRate: 0.1\n# maximum deceleration per tick\nspeedDecayRate: 1\n\n# Customizable messages (you can use color codes)\nmessages:\n  onRoad: \"\u0026cYou are on a road!\"\n  noPermission: \"\u00264You do not have permission to use this command.\"\n  reloadSuccess: \"\u0026aConfiguration reloaded successfully.\"\n  listHeader: \"\u00266Roads:\"\n  help:\n    header: \"\u0026bEasyRoads commands:\"\n    reload: \"\u00267/easyroads reload - Reload the EasyRoads configuration.\"\n    list: \"\u00267/easyroads list - List all roads.\"\n    help: \"\u00267/easyroads help - Display this help message.\"\n  invalidCommand: \"\u0026cInvalid subcommand. Use /easyroads help for available commands.\"\n\n# Affected non-player living entities, may affect performance negatively\n# See https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html\naffectedEntities: [ ]\n\n# Road definitions\nroads:\n  road1:\n    speed: 0.5\n    blocks:\n      - DIRT_PATH\n  road2:\n    speed: 3\n    blocks:\n      - ANY\n      - GRAVEL\n      - COBBLESTONE\n      - COBBLESTONE\n  road3:\n    speed: 5\n    blocks:\n      - Any\n      - STONE_BRICKS\n      - GRAVEL\n      - COBBLESTONE\n      - COBBLESTONE\n```\nExample roads\n![Screenshot 2024-08-22 at 18 49 22](https://github.com/user-attachments/assets/ea7e2e9c-c0a5-4183-b733-d00eb46a796b)\n\n\n## Commands 📝\n```/easyroads help:``` Display the help message.\n\n```/easyroads reload``` Reload the plugin configuration.\n\n```/easyroads list``` List all configured roads.\n## Permissions 🔑\n```easyroads.reload``` Permission to reload the configuration.\n\n```easyroads.list``` Permission to list all roads.\n## Troubleshooting 🛠️\nIf you encounter issues, check the server console for error messages and ensure that the configuration file is correctly formatted. For further assistance, feel free to open an issue on the GitHub repository.\n## Contributing 🤝\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\n## License 📜\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalbarczykdev%2Feasyroads","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkalbarczykdev%2Feasyroads","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalbarczykdev%2Feasyroads/lists"}