{"id":19439035,"url":"https://github.com/majekdev/simplehomes","last_synced_at":"2025-04-24T22:32:25.454Z","repository":{"id":37962800,"uuid":"364023951","full_name":"MajekDev/SimpleHomes","owner":"MajekDev","description":"Base homes plugin with all the essential features.","archived":false,"fork":false,"pushed_at":"2023-02-28T14:00:33.000Z","size":200,"stargazers_count":6,"open_issues_count":11,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-17T16:12:37.201Z","etag":null,"topics":["home-plugin","homes","minecraft","papermc","spigot"],"latest_commit_sha":null,"homepage":"","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/MajekDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-03T18:28:17.000Z","updated_at":"2023-10-30T19:43:18.000Z","dependencies_parsed_at":"2023-02-08T11:50:15.712Z","dependency_job_id":null,"html_url":"https://github.com/MajekDev/SimpleHomes","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MajekDev%2FSimpleHomes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MajekDev%2FSimpleHomes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MajekDev%2FSimpleHomes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MajekDev%2FSimpleHomes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MajekDev","download_url":"https://codeload.github.com/MajekDev/SimpleHomes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223969380,"owners_count":17233648,"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":["home-plugin","homes","minecraft","papermc","spigot"],"created_at":"2024-11-10T15:20:52.716Z","updated_at":"2024-11-10T15:20:53.353Z","avatar_url":"https://github.com/MajekDev.png","language":"Java","funding_links":["https://paypal.com/paypalme/majekdor"],"categories":[],"sub_categories":[],"readme":"\u003cimg align=\"right\" src=\"https://github.com/MajekDev/SimpleHomes/blob/main/img/logo.png?raw=true\" height=\"200\" width=\"220\"\u003e\n\u003ch1 align=\"center\"\u003eSimpleHomes by Majekdor\u003c/h1\u003e\n\nSimpleHomes is a stable base homes plugin. It offers all the essential features necessary in a homes plugin and some additional useful permissions. If you're looking for a more featured homes plugin with many more commands/permissions, then you'll want to take a look at UltimateHomes.\n\n## Commands\n\nThere are only 5 commands in SimpleHomes.\n- **/sethome [name]** - Set a new home at your current location.\n- **/home [player|name] [name]** - Teleport to a certain home.\n- **/homes [player]** - View a paginated list of homes.\n- **/delhome [player|name] [name]** - Delete a certain home.\n- **/simplehomes [help|reload]** - Get help or reload the plugin.\n\n## Permissions\n\nThere are a number of permissions available to modify what certain players can do.\n\nThese are given to all players automatically, but can be negated with a permission manager such as [LuckPerms](https://github.com/lucko/LuckPerms):\n- `simplehomes.sethome` - Allows players to set a home.\n- `simplehomes.home` - Allows players to go to one of their homes.\n- `simplehomes.homes` - Allows players to view a list of their homes.\n- `simplehomes.delhome` - Allows players to delete one of their homes.\n- `simplehomes.nether` - Allows players to set homes in the nether dimension.\n- `simplehomes.end` - Allows players to set homes in the end dimension.\n\nThese are only given to opped players automatically:\n- `simplehomes.delhome.other` - Allows players to delete another player's home.\n- `simplehomes.home.other` - Allows players to travel to another player's home.\n- `simplehomes.homes.other` - Allows players to view other player's homes.\n- `simplehomes.reload` - Allows players to reload the plugin.\n- `simplehomes.sethome.unlimited` - Allows players to set unlimited homes.\n- `simplehomes.delay.bypass` - Allows players to bypass the teleport delay.\n\nTo set a player's max homes limit with permissions use `simplehomes.sethome.max.\u003cinteger\u003e`, replacing `\u003cinteger\u003e` with the number of max homes.\n\n\u003e Note: If you set a lower home limit than what has been set before, the lower limit will not overwrite the higher limit. Meaning if a player has, for example, a home limit of 5 and you set it to 3 via permissions, it will remain 5. To lower it you must manually edit the player's JSON file. \n\n## Configuration\n\nThe default `config.yml` is available [here](https://github.com/MajekDev/SimpleHomes/blob/main/src/main/resources/config.yml) where a handful of configuration options can be changed. To make these changes take effect run `/simplehomes reload`. If you have questions about the configuration or want to suggest a new configuration option you can discuss that in [Discord](https://discord.majek.dev).\n\nAll messages sent by SimpleHomes are stored in the `lang.yml` file [here](https://github.com/MajekDev/SimpleHomes/blob/main/src/main/resources/lang.yml) and can be changed/translated. Color codes and other formatting are done using [MiniMessage](https://docs.adventure.kyori.net/minimessage.html#the-components). Legacy color codes (`\u0026c`, `\u0026l`, etc.) will not work. Those are being removed from Minecraft entirely in the near future.\n\n## For the nerds... I meean devs :P\n\nSimpleHomes stores homes using JSON. When the plugin is installed the `playerdata` folder is created and every player has a file named with their unique id. When homes are set/deleted the file updates in real time. The plugin also depends heavily on [adventure](https://github.com/KyoriPowered/adventure) by Kyori for components in chat. SimpleHomes has an API and documentation for that is coming.\n\n## Support\n\nIf you need help with the plugin and can't find the answer here or on Spigot, then the best way to get help is to join my [Discord](https://discord.gg/CGgvDUz). Make sure you read the frequently-asked channel before posting in the bug-reports channel (if it's a bug) or in the simple-homes channel (for general help).\n\nIf you have discovered a bug you can either join my [Discord](https://discord.gg/CGgvDUz) and report it there or open an issue here on GitHub. Please do not message me on Spigot in regard to a bug, there are easier ways to communicate.\n\n\n## Contributing\n\nSimpleHomes is open-source and licensed under the [MIT License](https://github.com/MajekDev/SimpleHomes/blob/main/LICENSE), so if you want to use any code contained in the plugin or clone the repository and make some changes, go ahead!\n\nIf you've found a bug within the plugin and would like to just make the changes to fix it yourself, you're free to do so and make a pull request here on GitHub. If you make significant contributions to the project, and by significant I mean one little PR to fix a tiny bug doesn't count as significant, you can earn the Contributor role in my [Discord](https://discord.gg/CGgvDUz).\n\n\n## Donate\n\nI'm a full time college student who makes and supports these plugins in my free time (when I have any). As a long time supporter of open source, most of my plugins are free. If you enjoy my plugins and would like to support me, you can buy me coffee over on  [PayPal](https://paypal.com/paypalme/majekdor). Donations of any amount are appreciated and a donation of $10 or more will get you the Supporter role in my [Discord](https://discord.gg/CGgvDUz)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajekdev%2Fsimplehomes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmajekdev%2Fsimplehomes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajekdev%2Fsimplehomes/lists"}