ResidenceList
List existing residence in server in a gui, and allow players to manage, teleport, and comment.
Автор: Carm2,6 тыс.10обновлён 27 окт. 2026 г.
УправлениеОбщение
Описание
___ _ __ __ _ __
/ _ \___ ___ (_)__/ /__ ___ _______ / / (_)__ / /_
/ , _/ -_|_-</ / _ / -_) _ \/ __/ -_) /__/ (_-</ __/
/_/|_|\__/___/_/\_,_/\__/_//_/\__/\__/____/_/___/\__/
README LANGUAGES [ English | 中文 ]
ResidenceList
Great "Residence" all listed !
List existing residence in server in a gui, and allow players to manage, teleport, and comment.
Features & Advantages
- Display all residences in a GUI!
- Allow players to edit residence's nickname, description, icon and public status!
- Allow players to pin their favourite residences!
- Allow players to rate & comment residences!
- Admin can manage all residences in a GUI!
Screenshots
Dependencies
- [Necessary] Residence part base on Residence.
- [Recommend] Placeholders based on PlaceholderAPI .
For development dependencies, please see Dependencies .
Commands
Player commands
Main command is /ResidenceList or /reslist.
# help
- Display all plugin commands
# open [player-name]
- Open the residence list gui
# info <residence-name>
- Display the residence info
# edit <residence-name>
- Open the residence edit gui
Admin commands
Main command is /ResidenceListAdmin or /reslistadmin, with permission residencelist.admin.
# open [player-name]
- Open the residence manage list gui
# edit <residence-name>
- Open the residence edit gui
# reload
- Reload the plugin configuration
Placeholders
This function based on PlaceholderAPI . You should install it before using placeholders in game.
# %residencelist_status_<residence>%
- Display the residence public status
# %residencelist_name_<residence>%
- Display the residence alias name or the residence name(if alias not set)
Configurations
You can find configuration translations at ResidenceList-Translations.
Plugin Configuration (config.yml)
Will be generated on the first boot up.
Messages Configuration (messages.yml)
Will be generated on the first boot up.
Permissions
# ResidenceList.admin
- The permissions for all admin commands and functions.
Statistics
Open Source Licence
The source code of this project adopts the GNU General Public License v3.0.
Supports
This project is mainly developed by the Artfrom Games .
Many thanks to Jetbrains for kindly providing a license for us to work on this and other open-source projects.
Галерея
Последние версии
Все версии →release
[1.4.0] Update: Visitors and MySQL Storage
1.4.027 окт. 2026 г.6Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
- `feat(storage)` Support MySQL storage, with shared player settings and separate residence data for each server. [[#29](https://github.com/ArtformGames/ResidenceList/issues/29)](https://github.com/ArtformGames/ResidenceList/issues/29)
- `feat(visitors)` Record unique visitors, excluding residence owners. Store each visitor's UUID, name, and latest visit time. [[#136](https://github.com/ArtformGames/ResidenceList/issues/136)](https://github.com/ArtformGames/ResidenceList/issues/136)
- `feat(view)` View visitor history from residence details and management pages, and sort residences by visitor count. Visitor icons can be configured separately for each page.
- `feat(papi)` Add `%residencelist_visitors_<residence>%` to display the unique visitor count.
- `perf(storage)` Cache data and perform storage operations asynchronously. Save visitor changes in batches every 60 seconds by default, and flush pending changes on shutdown.
- `fix(data)` Fix deleted comments reappearing after restart. Improve data handling during reconnects, residence renames, deletions, and failed saves.
- `fix(view)` Fix leftover empty-state icons and page selection when switching between lists.
- `chore(deps)` Update XSeries, PlaceholderAPI, bStats, database dependencies, and build tools.
> YAML remains the default storage, and existing YAML data is supported. Switching to MySQL does **not** automatically import YAML data.
>
> When sharing a MySQL database, assign each server a unique top-level `server-id`. If left blank, the server's listening port is used.
>
> Configure the visitor save interval with `settings.visitor-save-interval-seconds`. Restart after changing storage settings or the save interval.
> **For developers:** `ResidenceData.renameTo(File)` has been removed; use `ResidenceManager.renameResidence(...)` instead. Visitor APIs and asynchronous storage initialization and flush methods are now available.
**Full Changelog**: [[1.3.8...1.4.0](https://github.com/ArtformGames/ResidenceList/compare/1.3.8...1.4.0)](https://github.com/ArtformGames/ResidenceList/compare/1.3.8...1.4.0)
release
[1.3.8] Update: Comment deletions.
1.3.813 янв. 2026 г.639Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
#### What's Changed
* fix(deps): update dependency me.clip:placeholderapi to v2.11.7 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/128
* chore(deps): update dependency org.apache.maven.plugins:maven-jar-plugin to v3.5.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/129
* chore(deps): update dependency org.apache.maven.plugins:maven-source-plugin to v3.4.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/131
* chore(deps): update actions/checkout action to v6 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/130
* chore(deps): update actions/upload-artifact action to v5 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/127
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.6.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/133
* chore(deps): update actions/upload-artifact action to v6 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/132
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.7...1.3.8
release
[1.3.7] Update: Residence 6.x Support
1.3.717 окт. 2025 г.182Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
- `feat` Support for Residence `6.x` #121
- `fix` Try to fix pattern errors. #124
#### What's Changed
* chore(deps): update dependency org.apache.maven.plugins:maven-shade-plugin to v3.6.1 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/117
* chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.4 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/118
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.4.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/119
* chore(deps): update dependency org.apache.maven.plugins:maven-compiler-plugin to v3.14.1 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/120
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.5.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/125
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.5.1 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/126
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.6...1.3.7
release
[1.3.6] Fix: "Hidden" flag
1.3.65 сент. 2025 г.102Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
#### What's Changed
* build(deps): Bump org.jetbrains:annotations from 26.0.2 to 26.0.2-1 by @dependabot[bot] in https://github.com/ArtformGames/ResidenceList/pull/116
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.5...1.3.6
release
[1.3.5] Update: Hidden flag
1.3.52 сент. 2025 г.45Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
- `feat(view)` Replace "public-display" option with residences' "HIDDEN" flag.
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.4...1.3.5
release
[1.3.4] Update: 1.21.8 Support
1.3.427 авг. 2025 г.53Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
#### What's Changed
* build(deps): Bump com.github.cryptomorin:XSeries from 13.2.0 to 13.3.1 by @dependabot[bot] in https://github.com/ArtformGames/ResidenceList/pull/107
* fix(deps): update deps.easyplugin.version to v1.5.14 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/106
* build(deps): Bump org.apache.maven.plugins:maven-clean-plugin from 3.4.1 to 3.5.0 by @dependabot[bot] in https://github.com/ArtformGames/ResidenceList/pull/105
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.3.1 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/104
* chore(deps): update dependency org.apache.maven.plugins:maven-clean-plugin to v3.5.0 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/103
* chore(deps): update advanced-security/maven-dependency-submission-action digest to df268dd by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/102
* chore(deps): update actions/checkout action to v5 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/112
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.3.3 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/109
* chore(deps): update actions/setup-java action to v5 by @renovate[bot] in https://github.com/ArtformGames/ResidenceList/pull/113
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.3...1.3.4
release
[1.3.3] Fix: Data Loading
1.3.329 мая 2025 г.142Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
- `fix(data)` Fixed data loading issues when user login #100
#### What's Changed
* build(deps): Bump org.apache.maven.plugins:maven-surefire-plugin from 3.5.1 to 3.5.2 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/68
* build(deps): Bump com.github.cryptomorin:XSeries from 11.3.0 to v12.0.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/70
* chore: Configure Renovate by @renovate in https://github.com/ArtformGames/ResidenceList/pull/71
* fix(deps): update dependency com.github.cryptomorin:xseries to v12.1.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/73
* chore(deps): update advanced-security/maven-dependency-submission-action digest to 49866fe by @renovate in https://github.com/ArtformGames/ResidenceList/pull/72
* chore(deps): update actions/checkout action to v4 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/76
* fix(deps): update dependency org.bstats:bstats-bukkit to v3.1.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/75
* fix(deps): update dependency com.github.cryptomorin:xseries to v13 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/78
* chore(deps): update actions/setup-java action to v4 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/77
* fix(deps): update dependency org.jetbrains:annotations to v26.0.2 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/79
* build(deps): Bump org.apache.maven.plugins:maven-compiler-plugin from 3.13.0 to 3.14.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/87
* build(deps): Bump cc.carm.lib:mineconfiguration-bukkit from 2.9.3 to 3.0.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/86
* build(deps): Bump org.apache.maven.plugins:maven-clean-plugin from 3.4.0 to 3.4.1 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/85
* chore(deps): update dependency org.apache.maven.plugins:maven-compiler-plugin to v3.14.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/84
* chore(deps): update dependency org.apache.maven.plugins:maven-clean-plugin to v3.4.1 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/82
* fix(deps): update dependency cc.carm.lib:mineconfiguration-bukkit to v3.0.3 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/89
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.1.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/90
* fix(deps): update dependency cc.carm.lib:mineconfiguration-bukkit to v3.1.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/91
* fix(deps): update dependency cc.carm.lib:mineconfiguration-bukkit to v3.1.1 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/92
* fix(deps): update dependency com.github.cryptomorin:xseries to v13.2.0 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/93
* build(deps): Bump org.apache.maven.plugins:maven-surefire-plugin from 3.5.2 to 3.5.3 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/95
* chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.3 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/94
* chore(deps): update advanced-security/maven-dependency-submission-action digest to 4bf8a28 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/96
* chore(deps): update advanced-security/maven-dependency-submission-action digest to 4b6fc92 by @renovate in https://github.com/ArtformGames/ResidenceList/pull/101
#### New Contributors
* @renovate made their first contribution in https://github.com/ArtformGames/ResidenceList/pull/71
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.2...1.3.3
release
[1.3.2] Feature: Auto-Remove
1.3.218 окт. 2024 г.272Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
- `fix` Fixed the error when initializing config.
#### What's Changed
* build(deps): Bump com.github.cryptomorin:XSeries from 11.2.1 to v11.2.2 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/57
* build(deps): Bump org.jetbrains:annotations from 24.1.0 to 25.0.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/58
* build(deps): Bump com.github.cryptomorin:XSeries from v11.2.2 to 11.3.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/59
* build(deps): Bump org.apache.maven.plugins:maven-surefire-plugin from 3.5.0 to 3.5.1 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/60
* build(deps): Bump org.jetbrains:annotations from 25.0.0 to 26.0.0 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/61
* build(deps): Bump org.jetbrains:annotations from 26.0.0 to 26.0.1 by @dependabot in https://github.com/ArtformGames/ResidenceList/pull/66
*
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.1...1.3.2
release
[1.3.1] Fix: Data Error
1.3.118 сент. 2024 г.115Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
- `fix` Fixed the error if a residence's icon unset
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.3.0...1.3.1
release
[1.3.0] Feature: Custom Icon
1.3.017 сент. 2024 г.114Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4paper, purpur, spigot
Что нового
- `feat(icon)` Support custom-model-data in residences' icon.
**Full Changelog**: https://github.com/ArtformGames/ResidenceList/compare/1.2.3...1.3.0