{"id":16558972,"url":"https://github.com/gabizou/happytrails","last_synced_at":"2025-08-22T08:13:44.626Z","repository":{"id":81099479,"uuid":"93182341","full_name":"gabizou/HappyTrails","owner":"gabizou","description":null,"archived":false,"fork":false,"pushed_at":"2019-10-10T16:25:07.000Z","size":57,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-08T23:35:36.943Z","etag":null,"topics":["minecraft","plugin","sponge","spongeapi"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gabizou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"License.txt","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},"funding":{"github":"gabizou","patreon":"gabizou"}},"created_at":"2017-06-02T16:04:29.000Z","updated_at":"2019-10-10T16:25:09.000Z","dependencies_parsed_at":"2023-05-04T09:47:09.170Z","dependency_job_id":null,"html_url":"https://github.com/gabizou/HappyTrails","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/gabizou/HappyTrails","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabizou%2FHappyTrails","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabizou%2FHappyTrails/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabizou%2FHappyTrails/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabizou%2FHappyTrails/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabizou","download_url":"https://codeload.github.com/gabizou/HappyTrails/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabizou%2FHappyTrails/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271606595,"owners_count":24788979,"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","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["minecraft","plugin","sponge","spongeapi"],"created_at":"2024-10-11T20:24:18.923Z","updated_at":"2025-08-22T08:13:44.619Z","avatar_url":"https://github.com/gabizou.png","language":"Java","funding_links":["https://github.com/sponsors/gabizou","https://patreon.com/gabizou"],"categories":[],"sub_categories":[],"readme":"# HappyTrails\n\nWelcome to **HappyTrails**, a trails plugin for Sponge!\n\nAuthors: gabizou\n\nThe intention of this plugin is pretty simple: Make fancy trails for \nplayers to use in game with permissions! The limit is only as far as your\nimagination! There are a default set of trails provided, however, they\nare not required to persist! You, as a server administrator, can customize\nevery single trail and even add or remove trails!\n\n#### Current Features\n- Set trails on yourself\n- Remove a trail from yourself\n- Trails persist between restarts/logins so you don't have to set it every time!\n- Fallback trails to the default if your last used trail was removed or changed!\n- Only uses SpongeAPI 5.x as a base, so compatible with Minecraft 1.10.2 servers and up!\n\n#### Commands\n\nCommand | Description | Permission\n--------| ------------| ----------\n/trail set \\\u003ctrailId\u003e | Sets your current trail to the desired one | happytrails.command.set\n/trail reset | Resets your trail, removes it from you as a player | happytrails.command.reset\n\n#### Trail Config\n\nThe configuration file is fairly dynamic. It will generate a default set of\ntrails for you, as a server owner, to utilize and familiarize yourself with the\noptions. The trails themselves are fully serializable and deserializable\nusing Sponge's native systems. The current default configuration looks like so:\n```hocon\ndefaultTrail=\"happytrails:hearts\"\ntrails=[\n    {\n        ContentVersion=1\n        id=\"happytrails:hearts\"\n        name=Hearts\n        \"particle_effect\" {\n            Options=[\n                {\n                    Option=\"minecraft:velocity\"\n                    Value {\n                        x=0.5\n                        y=1.0\n                        z=0.4\n                    }\n                },\n                {\n                    Option=\"minecraft:quantity\"\n                    Value=7\n                }\n            ]\n            Type=\"minecraft:heart\"\n        }\n        period=10\n        radius=30\n    },\n    {\n        ContentVersion=1\n        id=\"happytrails:villager_happy\"\n        name=\"Happy Villager\"\n        \"particle_effect\" {\n            Options=[\n                {\n                    Option=\"minecraft:offset\"\n                    Value {\n                        x=0.5\n                        y=1.0\n                        z=0.4\n                    }\n                },\n                {\n                    Option=\"minecraft:velocity\"\n                    Value {\n                        x=0.5\n                        y=1.0\n                        z=0.4\n                    }\n                },\n                {\n                    Option=\"minecraft:quantity\"\n                    Value=13\n                }\n            ]\n            Type=\"minecraft:happy_villager\"\n        }\n        period=10\n        radius=30\n    },\n    {\n        ContentVersion=1\n        id=\"happytrails:villager_storm\"\n        name=\"Stormy Villager\"\n        \"particle_effect\" {\n            Options=[\n                {\n                    Option=\"minecraft:offset\"\n                    Value {\n                        x=0.0\n                        y=3.0\n                        z=0.0\n                    }\n                },\n                {\n                    Option=\"minecraft:velocity\"\n                    Value {\n                        x=0.0\n                        y=0.1\n                        z=0.0\n                    }\n                },\n                {\n                    Option=\"minecraft:quantity\"\n                    Value=5\n                }\n            ]\n            Type=\"minecraft:angry_villager\"\n        }\n        period=10\n        radius=30\n    },\n    {\n        ContentVersion=1\n        id=\"happytrails:crit_strike\"\n        name=\"Critical Strike\"\n        \"particle_effect\" {\n            Options=[\n                {\n                    Option=\"minecraft:color\"\n                    Value {\n                        Blue=139\n                        ContentVersion=1\n                        Green=139\n                        Red=0\n                    }\n                },\n                {\n                    Option=\"minecraft:offset\"\n                    Value {\n                        x=10.0\n                        y=3.0\n                        z=10.0\n                    }\n                },\n                {\n                    Option=\"minecraft:quantity\"\n                    Value=10\n                }\n            ]\n            Type=\"minecraft:critical_hit\"\n        }\n        period=5\n        radius=20\n    },\n    {\n        ContentVersion=1\n        id=\"happytrails:cloud\"\n        name=Clouds\n        \"particle_effect\" {\n            Options=[\n                {\n                    Option=\"minecraft:offset\"\n                    Value {\n                        x=0.0\n                        y=3.0\n                        z=0.0\n                    }\n                },\n                {\n                    Option=\"minecraft:velocity\"\n                    Value {\n                        x=0.01\n                        y=0.01\n                        z=0.01\n                    }\n                },\n                {\n                    Option=\"minecraft:quantity\"\n                    Value=2\n                }\n            ]\n            Type=\"minecraft:cloud\"\n        }\n        period=1\n        radius=10\n    }\n]\n\n```\n\n#### Future Features\n- Dynamic trails that change with each time they are spawned (think rainbows)\n- Randomization of trails (using a trail that allows for random values to be set)\n- Creation of trails through commands with an in game menu system\n- Per trail permissions\n- Maybe allowing multiple trails to be set at once\n\n#### Version History\n\n\nVersion | Features / Changes | Date\n--------|--------------------|-------\n0.1.0 | \u003cul\u003e\u003cli\u003eConfigurable Trails\u003c/li\u003e\u003cli\u003eTrails have period duration and player range\u003c/li\u003e\u003c/ul\u003e | July 9th, 2017\n0.1.1 | \u003cul\u003e\u003cli\u003ePer-trail permissions. The permission for the trail is based on the `id` of the trail *after* the plugin id. So, if the id is `happytrails:villager_storm`, the permission will be `happytrails.trail.villager_storm` | July 9th, 2017\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabizou%2Fhappytrails","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabizou%2Fhappytrails","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabizou%2Fhappytrails/lists"}