# Better IP Use (BIU)<\/p>\n
\u62a5\u544a\u95ee\u9898\u53ca\u53d1\u5e03\uff1ahttps:\/\/github.com\/my-txz\/better_ip_use\/issues<\/p>\n
Reporting issues and publishing:https:\/\/github.com\/my-txz\/better_ip_use\/issues<\/p>\n
\n
\n<\/p>\n
A lightweight, conflict-resistant Minecraft plugin that displays player geolocation and filters inappropriate chat using **built-in integrations with Uapipro APIs**. Features include smart location formatting, sensitive word detection, chat cooldowns, and a community-driven reporting system.<\/p>\n
\u4e00\u6b3e\u8f7b\u91cf\u7ea7\u3001\u6297\u51b2\u7a81\u7684 Minecraft \u63d2\u4ef6\uff0c\u901a\u8fc7**\u5185\u7f6e Uapipro API \u96c6\u6210**\u5b9e\u73b0\u73a9\u5bb6\u5730\u57df\u663e\u793a\u4e0e\u804a\u5929\u5185\u5bb9\u8fc7\u6ee4\u3002\u5305\u542b\u667a\u80fd\u5730\u57df\u683c\u5f0f\u5316\u3001\u654f\u611f\u8bcd\u68c0\u6d4b\u3001\u53d1\u8a00\u51b7\u5374\u53ca\u793e\u533a\u4e3e\u62a5\u7cfb\u7edf\u3002<\/p>\n
> \ud83d\ude4f Special thanks to **Uapipro** for providing reliable public APIs used in this plugin.
\n> \ud83d\ude4f \u7279\u522b\u9e23\u8c22 **Uapipro** \u63d0\u4f9b\u7a33\u5b9a\u53ef\u9760\u7684\u516c\u5171 API \u652f\u6301\u3002<\/p>\n
—<\/p>\n
# Tips:
\n### Version download corresponds to:
\n**1.X supports 1.19-1.20.6 | 2.X supports 1.20.6-1.21.11 | 3. X supports 1.13-1.18.2 (in development)**<\/p>\n
—
\n## \u2728 Core Features<\/p>\n
### \ud83c\udf0d Smart Geolocation Display
\nFetches region data via `https:\/\/uapis.cn\/api\/v1\/network\/ipinfo?ip=%IP%` and formats it consistently across three interfaces:<\/p>\n
– **Tab List**: Appends as suffix \u2192 `Steve [\u4e2d\u56fd \u5317\u4eac]`
\n– **Chat Message**: Rewrites format \u2192 `Steve[\u4e2d\u56fd \u5317\u4eac]: Hello!`
\n– **Nametag (Above Head)**: Uses prefix for visibility \u2192 `[\u4e2d\u56fd \u5317\u4eac] Steve` <\/p>\n
By default, regions are auto-trimmed to the first two space-separated parts (e.g., `”\u4e2d\u56fd \u5317\u4eac \u6d77\u6dc0\u533a”` \u2192 `”\u4e2d\u56fd \u5317\u4eac”`). Configurable via `display.region_format: auto | full`.<\/p>\n
### \ud83d\udeab Sensitive Word Filtering
\nUses `https:\/\/uapis.cn\/api\/v1\/sensitive-word\/quick-check` to detect violations. A message is flagged if:
\n– Response contains `”status”: “forbidden”`, **or**
\n– The `forbidden_words` array has \u22651 entry.<\/p>\n
**Punishment flow**:
\n1. First offense \u2192 warning
\n2. Repeat offense \u2192 mute (default: 5 minutes)
\n3. Optional broadcast on mute<\/p>\n
Bypass permission: `better_ip_use.bypass`.<\/p>\n
### \u23f3 Chat Cooldown System
\nPrevents spam by enforcing a configurable delay between messages (default: 5 seconds). Players see a countdown when violating.<\/p>\n
### \ud83d\udce2 Community Reporting (`\/biu report ### \u267b\ufe0f Resource Efficiency & Cleanup ### \u2699\ufe0f Conflict-Aware Event Handling —<\/p>\n ## \u26a0\ufe0f Requirements<\/p>\n – **Minecraft**: Spigot\/Paper **1.19 to 1.20.4** (inclusive) > \u2757 This plugin **currently only supports** Java 17 and Minecraft 1.19\u20131.20.4. > \ud83d\udd27 **We are currently adapting BIU for Bukkit. You may try it at your own risk.** —<\/p>\n ## \ud83d\udd27 Configuration Highlights (`config.yml`)<\/p>\n “`yaml # \u529f\u80fd\u5f00\u5173 # \u804a\u5929\u51b7\u5374\u8bbe\u7f6e # \u4e3e\u62a5\u7cfb\u7edf\u8bbe\u7f6e # API \u914d\u7f6e # \u663e\u793a\u8bbe\u7f6e # Tab \u5217\u8868\u540e\u7f00 # \u5904\u7f5a\u8bbe\u7f6e # \u6d88\u606f\u591a\u8bed\u8a00\u914d\u7f6e en: All display elements share the same color and fallback text.<\/p>\n —<\/p>\n ## \ud83d\udcdc Commands & Permissions<\/p>\n | Command | Permission | Description | Default permissions: ops only. Tab completion supported.<\/p>\n —<\/p>\n ## \ud83d\udce6 Deployment<\/p>\n 1. Place `BetterIPUse.jar` in `plugins\/` No extra dependencies \u2014 uses Spigot\u2019s built-in Gson.<\/p>\n —<\/p>\n > No telemetry, no ads, no hidden features. This is a plugin that improves the Minecraft server experience and quality using IP, featuring high performance, multi-compatibility, and high configurability.<\/p>\n","protected":false},"featured_media":29809,"template":"","meta":{"_minecraft_slug":"better_ip_use","_minecraft_project_id":"4FfCyL6Y","_minecraft_author":"my-txz","_minecraft_license":"Apache-2.0","_minecraft_downloads":50,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"better_ip_use.zip","_minecraft_size_bytes":117632,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T21:12:23.126453Z","_minecraft_date_created":"2026-02-09T23:40:10.992099Z","_minecraft_date_modified":"2026-02-08T08:21:56.779309Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/better_ip_use","_minecraft_icon_attachment_id":29809,"_minecraft_imported_at":"2026-06-01T12:25:18+00:00","_minecraft_import_hash":"a98741b87024098d25dc482c4fd17c1a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,89,873,126,127,128,867,129,91,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-29808","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nPlayers can report others for recent inappropriate speech:
\n– Checks up to **3 messages** from the last **5 minutes**
\n– Reporter cooldown: **5 minutes** (configurable)
\n– If any message violates rules, target is **automatically muted**
\n– Fully asynchronous \u2014 no server lag<\/p>\n
\n– IP-to-region results are cached per player
\n– All player data (cache, history, mutes) is cleaned on quit
\n– Manual cache clearing via `\/biu clearcache`
\n– Chat history automatically expires after 10 minutes to save memory<\/p>\n
\n– **Display updates** use `EventPriority.MONITOR` \u2014 runs *after* plugins like Essentials\/CMI
\n– **Chat formatting** uses `EventPriority.HIGH` \u2014 reliably overrides most chat systems<\/p>\n
\n– **Java**: **17+**
\n– **Internet Access**: Must reach `uapis.cn`<\/p>\n
\n> \u2757 \u672c\u63d2\u4ef6**\u76ee\u524d\u4ec5\u652f\u6301** Java 17 \u53ca Minecraft 1.19\u20131.20.4\u3002<\/p>\n
\n> \ud83d\udd27 **\u6211\u4eec\u6b63\u5728\u5bf9 Bukkit \u8fdb\u884c\u9002\u914d\uff0c\u53ef\u4ee5\u81ea\u884c\u8fdb\u884c\u5c1d\u8bd5\u3002**<\/p>\n
\n# \u8bed\u8a00\u8bbe\u7f6e: zh \/ en
\nlanguage: “zh”<\/p>\n
\nsettings:
\n # \u542f\u7528\u804a\u5929\u5408\u89c4\u68c0\u67e5
\n enable_chat_check: true
\n # \u542f\u7528\u9884\u5ba1\u6838\u6a21\u5f0f (true = \u53d1\u9001\u540e\u5ba1\u6838\u518d\u663e\u793a, false = \u5b9e\u65f6\u5ba1\u6838\u62e6\u622a)
\n # true: \u73a9\u5bb6\u53d1\u9001 -> \u670d\u52a1\u5668\u5ba1\u6838 -> \u901a\u8fc7\u5219\u5e7f\u64ad\u663e\u793a, \u4e0d\u901a\u8fc7\u5219\u5c4f\u853d
\n # false: \u73a9\u5bb6\u53d1\u9001 -> \u5b9e\u65f6\u68c0\u6d4b -> \u8fdd\u89c4\u5219\u62e6\u622a\u5e76\u53d6\u6d88\u4e8b\u4ef6
\n pre_moderation: true
\n # \u542f\u7528 IP \u663e\u793a (Tab\/\u5934\u9876\/\u804a\u5929)
\n enable_ip_display: true<\/p>\n
\nchat_cooldown:
\n enabled: true
\n # \u51b7\u5374\u65f6\u95f4 (\u79d2)
\n seconds: 5<\/p>\n
\nreport_system:
\n enabled: true
\n # \u68c0\u67e5\u51e0\u5206\u949f\u5185\u7684\u6d88\u606f
\n check_minutes_ago: 5
\n # \u4e3e\u62a5\u51b7\u5374\u65f6\u95f4 (\u79d2)
\n reporter_cooldown_seconds: 300
\n # \u6bcf\u6b21\u6700\u591a\u68c0\u67e5\u51e0\u6761\u6d88\u606f
\n max_check_messages: 3<\/p>\n
\napi:
\n sensitive_word:
\n # \u6b63\u786e\u7684API\u7aef\u70b9 – \u4f7f\u7528uapis.cn\u7684\u654f\u611f\u8bcd\u68c0\u6d4b\u63a5\u53e3
\n url: “https:\/\/uapis.cn\/api\/v1\/text\/profanitycheck”
\n ip_info:
\n # IP\u4fe1\u606f\u67e5\u8be2\u63a5\u53e3\u6a21\u677f
\n url_template: “https:\/\/uapis.cn\/api\/v1\/network\/ipinfo?ip=%IP%”<\/p>\n
\ndisplay:
\n region_format: “auto” # auto (\u53d6\u524d\u4e24\u7ea7) \u6216 full (\u5b8c\u6574)
\n color: “&3”
\n unknown_text: “Unknown”<\/p>\n
\n tab_suffix_enabled: true
\n # \u804a\u5929\u540e\u7f00
\n chat_suffix_enabled: true
\n # \u5934\u9876\u524d\u7f00
\n nametag_prefix_enabled: true<\/p>\n
\npunishment:
\n warn_first: true
\n mute_minutes: 5
\n broadcast_on_mute: true<\/p>\n
\nmessages:
\n zh:
\n prefix: “&3[&bBIU&3] &r”
\n warn: “&c\u60a8\u7684\u53d1\u8a00\u5305\u542b\u4e0d\u5408\u89c4\u5185\u5bb9\uff0c\u8bf7\u6ce8\u610f\u6587\u660e\u7528\u8bed\u3002”
\n cooldown: “&c\u8bf7\u52ff\u9891\u7e41\u53d1\u8a00\uff0c\u8fd8\u9700\u7b49\u5f85 &e%time% &c\u79d2\u3002”
\n mute: “&c\u4f60\u56e0\u591a\u6b21\u8fdd\u89c4\u5df2\u88ab\u7981\u8a00 %mute_minutes% \u5206\u949f\u3002”
\n mute_admin: “&c\u4f60\u5df2\u88ab\u7ba1\u7406\u5458\u7981\u8a00\u3002”
\n mute_active: “&c\u4f60\u5f53\u524d\u5904\u4e8e\u7981\u8a00\u72b6\u6001\uff0c\u65e0\u6cd5\u53d1\u8a00\u3002”
\n mute_broadcast: “&c\u73a9\u5bb6 &e%player% &c\u56e0\u591a\u6b21\u8fdd\u89c4\u5df2\u88ab\u7981\u8a00 %mute_minutes% \u5206\u949f\u3002”
\n unmuted: “&a\u4f60\u5df2\u88ab\u89e3\u9664\u7981\u8a00\uff0c\u53ef\u4ee5\u6b63\u5e38\u53d1\u8a00\u4e86\u3002”
\n unmuted_auto: “&a\u4f60\u7684\u7981\u8a00\u65f6\u95f4\u5df2\u5230\uff0c\u5df2\u81ea\u52a8\u89e3\u9664\u7981\u8a00\u3002”
\n reload: “&a\u914d\u7f6e\u5df2\u91cd\u8f7d\u3002”
\n cache_cleared: “&aIP\u5730\u5740\u7f13\u5b58\u5df2\u6e05\u9664\uff0c\u6240\u6709\u73a9\u5bb6\u663e\u793a\u5df2\u91cd\u7f6e\u3002”
\n no_permission: “&c\u4f60\u6ca1\u6709\u6743\u9650\u6267\u884c\u6b64\u64cd\u4f5c\u3002”
\n help: |
\n &a\/biu help &7- \u663e\u793a\u5e2e\u52a9
\n &a\/biu reload &7- \u91cd\u8f7d\u914d\u7f6e
\n &a\/biu clearcache &7- \u6e05\u9664IP\u7f13\u5b58
\n &a\/biu report <\u73a9\u5bb6> &7- \u4e3e\u62a5\u73a9\u5bb6\u8fd1\u671f\u8fdd\u89c4\u53d1\u8a00
\n &a\/biu mute <\u73a9\u5bb6> &7- \u624b\u52a8\u7981\u8a00\u73a9\u5bb6
\n &a\/biu unmute <\u73a9\u5bb6> &7- \u89e3\u9664\u73a9\u5bb6\u7981\u8a00
\n &a\/biu check <\u6587\u672c> &7- \u68c0\u6d4b\u6587\u672c\u662f\u5426\u8fdd\u89c4
\n report_usage: “&c\u7528\u6cd5: \/biu report <\u73a9\u5bb6\u540d>”
\n report_disabled: “&c\u4e3e\u62a5\u7cfb\u7edf\u5f53\u524d\u5df2\u7981\u7528\u3002”
\n report_cooldown: “&c\u4e3e\u62a5\u529f\u80fd\u51b7\u5374\u4e2d\uff0c\u8fd8\u9700\u7b49\u5f85 &e%time% &c\u79d2\u3002”
\n report_self: “&c\u4e0d\u80fd\u4e3e\u62a5\u81ea\u5df1\u3002”
\n report_target_no_history: “&c\u8be5\u73a9\u5bb6\u8fd1\u671f\u65e0\u53ef\u4e3e\u62a5\u7684\u53d1\u8a00\u8bb0\u5f55\u3002”
\n report_checking: “&a\u6b63\u5728\u68c0\u67e5\u73a9\u5bb6 &e%player% &a\u7684\u8fd1\u671f\u53d1\u8a00…”
\n report_success_compliant: “&a\u4e3e\u62a5\u68c0\u67e5\u7ed3\u679c\uff1a\u73a9\u5bb6 &e%player% &a\u8fd1\u671f\u53d1\u8a00\u5408\u89c4\u3002”
\n report_success_forbidden: “&c\u4e3e\u62a5\u68c0\u67e5\u7ed3\u679c\uff1a\u73a9\u5bb6 &e%player% &c\u5b58\u5728\u8fdd\u89c4\u53d1\u8a00\uff0c\u5df2\u81ea\u52a8\u7981\u8a00\u3002”
\n report_broadcast: “&c\u73a9\u5bb6 &e%player% &c\u56e0\u88ab\u4e3e\u62a5\u8fdd\u89c4\u53d1\u8a00\uff0c\u5df2\u88ab\u7cfb\u7edf\u7981\u8a00\u3002\u4e3e\u62a5\u8005: &e%reporter%”
\n mute_cmd_usage: “&c\u7528\u6cd5: \/biu mute <\u73a9\u5bb6\u540d>”
\n unmute_cmd_usage: “&c\u7528\u6cd5: \/biu unmute <\u73a9\u5bb6\u540d>”
\n player_muted: “&c\u5df2\u624b\u52a8\u7981\u8a00\u73a9\u5bb6 &e%player%&c\u3002”
\n player_unmuted: “&a\u5df2\u89e3\u7981\u73a9\u5bb6 &e%player%&a\u3002”
\n player_not_found: “&c\u672a\u627e\u5230\u73a9\u5bb6: &e%player%&c\u3002”<\/p>\n
\n prefix: “&3[&bBIU&3] &r”
\n warn: “&cYour message contains non-compliant content. Please be civil.”
\n cooldown: “&cPlease do not spam. Wait &e%time% &cseconds.”
\n mute: “&cYou have been muted for %mute_minutes% minutes due to repeated violations.”
\n mute_admin: “&cYou have been muted by an administrator.”
\n mute_active: “&cYou are currently muted and cannot chat.”
\n mute_broadcast: “&cPlayer &e%player% &chas been muted for %mute_minutes% minutes.”
\n unmuted: “&aYou have been unmuted. You can chat normally now.”
\n unmuted_auto: “&aYour mute time has expired. You can chat normally now.”
\n reload: “&aConfiguration reloaded.”
\n cache_cleared: “&aIP address cache cleared.”
\n no_permission: “&cYou do not have permission.”
\n help: |
\n &a\/biu help &7- Show help
\n &a\/biu reload &7- Reload config
\n &a\/biu clearcache &7- Clear IP cache
\n &a\/biu report
\n &a\/biu mute
\n &a\/biu unmute
\n &a\/biu check
\n report_usage: “&cUsage: \/biu report
\n report_disabled: “&cReport system is currently disabled.”
\n report_cooldown: “&cReport function is on cooldown. Wait &e%time% &cseconds.”
\n report_self: “&cYou cannot report yourself.”
\n report_target_no_history: “&cTarget player has no recent chat history to report.”
\n report_checking: “&aChecking recent messages from &e%player%&a…”
\n report_success_compliant: “&aReport Result: Player &e%player% &ais compliant.”
\n report_success_forbidden: “&cReport Result: Player &e%player% &cviolated rules. Auto-muted.”
\n report_broadcast: “&cPlayer &e%player% &cwas muted due to report. Reporter: &e%reporter%”
\n mute_cmd_usage: “&cUsage: \/biu mute
\n unmute_cmd_usage: “&cUsage: \/biu unmute
\n player_muted: “&cPlayer &e%player%&c has been manually muted.”
\n player_unmuted: “&aPlayer &e%player%&c has been unmuted.”
\n player_not_found: “&cPlayer not found: &e%player%&c.”
\n“`<\/p>\n
\n|——–|————|————-|
\n| `\/biu help` | `better_ip_use.use` | Show help |
\n| `\/biu reload` | `better_ip_use.reload` | Reload config |
\n| `\/biu clearcache` | `better_ip_use.reload` | Clear IP cache |
\n| `\/biu report
\n| `\/biu mute
\n| `\/biu unmute
\n2. Start server to generate `config.yml`
\n3. Adjust settings if needed (defaults work out-of-box with Uapipro)
\n4. Use `\/biu reload` after changes<\/p>\n
\n> \u65e0\u9065\u6d4b\u3001\u65e0\u5e7f\u544a\u3001\u65e0\u9690\u85cf\u529f\u80fd\u3002
\n>
\n> **Complies with Modrinth Community Guidelines.**
\n> **\u9075\u5b88 Modrinth \u793e\u533a\u89c4\u8303\u3002**<\/p>\n","protected":false},"excerpt":{"rendered":"