SyncStaticMapView-Archive

Get the help/pre-release from Discord

============================================ NOTICE ============================================
The future will undergo a major revision, Everything will be redesigned
Name will be changed to SyncMapView in the revision, and way to migrate old data will be given
================================================================================================

- The map id actually used by this plugin is negative, will not cover any original map, but uses his own negative range, but the command input is not negative id!
- If the player permissions are updated and player has seen the map now, player must "relog in" / "leave and back" to display the latest redirect map id!
- The database not MariaDB, plugin's config.yml create-table-can-partition to false

Support:

• Paper
  • 1.19.4
  • 1.18.2
  • 1.17.1
• Spigot
  • 1.19.4
    
  • 1.18.2
  • 1.17.1

Description:

• As long as it is uploaded using the plug-in, it can be displayed normally no matter which server it is
• Allows players of different permission groups to see different maps
• Mostly asynchronous
• Does not interfere with the original map space (0~2147483647), the plugin uses negative space (-1~-2147483648)
• URL download image to simulate browser header
• Limit the number of uploads per player
• Rate limit to avoid hacking

Example:

• Suppose there are 4 maps, which are map id 11, 12, 13, 14, and the actual maps you get will be -11, -12, -13, -14
• The player has two permissions
  • image.see.a
  • image.see.bbbb
• Redirection configuration for map id 11
  (Smaller value, higher priority): (Have permission) => (Specify id map)
  • -12: image.ccc.test => 14
  • 77: image.see.a => 12
  • 1800: image.see.bbbb => 13

The map id 11 that the player sees at this time will be id 12

Command:

• /mapview reload
  Reload configuration
• /mapview get <Map id>
  Get map item in the database
• /mapview delete <Map id>
  Delete map in the database
• /mapview create url <Row amount>:<Column amount> <URL>
  Save web pictures to the database
• /mapview create file <Row amount>:<Column amount> <File>
  Save this map file to the database
• /mapview create hand
  Save the map in the master hand to the database
• /mapview redirect <Map id> list
  View all redirects that have been set for this map
• /mapview redirect <Map id> set <Priority> <Permission> <Redirected map id>
  Set a new redirect, the same priority or permission will be overwritten
• /mapview redirect <Map id> delete <Permission>
  Delete specific redirects for this map
• /mapview redirect <Map id> delete_all
  Delete all redirects for this map
• /mapview limit set <Player name|UUID> <Limit amount>
  Set the maximum number of map that the player is allowed to upload
• /mapview limit increase <Player name|UUID> <Limit amount>
  Increase the maximum number of map that players can upload
• /mapview limit subtract <Player name|UUID> <Limit amount>
  Reduce the maximum number of map that players can upload
• /mapview limit check
  Check the number of map you have used
• /mapview limit check <Player name|UUID>
  Check the number of map used

Permissions:

• command.mapview.*
• command.mapview.reload
• command.mapview.get_own
• command.mapview.get_all
• command.mapview.delete_own
• command.mapview.delete_all
• command.mapview.create.*
• command.mapview.create.url
• command.mapview.create.file
• command.mapview.create.hand
• command.mapview.redirect.*
• command.mapview.redirect.list
• command.mapview.redirect.set
• command.mapview.redirect.delete
• command.mapview.redirect.delete_all
• command.mapview.limit.*
• command.mapview.limit.set
• command.mapview.limit.increase
• command.mapview.limit.subtract
• command.mapview.limit.check_own
• command.mapview.limit.check_all
• mapview.ignore_size_restrictions
• mapview.ignore_upload_limit
• mapview.ignore_url_allowed
• mapview.ignore_create_rate_limit

Config:
Additional language:

• zh-tw
• en

# 資料庫
# database
database:
  ip: "127.0.0.1"
  port: 3306
  database: "!! YOUR_DATABASE_NAME !!"
  user: "!! YOUR_USER_NAME !!"
  password: "!! YOUR_USER_PASSWORD !!"

  # MariaDB https://mariadb.com/kb/en/about-mariadb-connector-j/#optional-url-parameters
  # MySQL   https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-reference-configuration-properties.html
  options:
    useUnicode: true
    characterEncoding: "UTF-8"
    useSSL: false
    serverTimezone: "GMT+8"

# 快取能保留多少時間 (毫秒)
# How long can the cache be retained (milliseconds)
cache-vitality-time: 60000

# 創建資料表時允許加入分區支持
#   如果資料庫是使用 MariaDB 可以啟用此選項
# Partition support is allowed when creating data tables
#   If the database is MariaDB can enable
create-table-can-partition: true

# 單次上傳允許的最大行數量
# Maximum number of rows allowed in a single upload
maximum-row-allowed: 8

# 單次上傳允許的最大欄數量
# Maximum number of columns allowed in a single upload
maximum-column-allowed: 8

# 預設玩家能上傳最大的地圖數量
#   如果裁切 2:2 那會是 4 個而不是 1 個
# Default player can upload the maximum number of maps
#   If cut 2:2 it will be 4 instead of 1
default-player-limit: 400

# 網址訪問速度限制 (秒)
#   全部網址共享一個速率限制器
#   避免遭受到大量上傳請求的駭客攻擊
#   未處理完畢卻關機, 會導致當前列隊全部消失
# URL access speed limit (second)
#   All url share a rate limit discard
#   Avoid hacker attacks from a large number of upload requests
#   Shutting down before processing is completed will cause all current queues to disappear
url-rate-limit: 4

# 指令創建地圖速率限制 (毫秒)
# Instruction to create a map rate limit (millisecond)
create-rate-limit: 2000

# 允許的網址來源清單
# List of allowed URL sources
allowed-url-source-list:
  - "https://i.imgur.com/"
  -

# 如果裁切只有 1:1 則會獲得的地圖物品標籤
# If the crop is only 1:1, will get the map item tag
item-single-tag: "{map:%mapview.id%}"
# 如果裁切大於 1:1 則會獲得的地圖物品標籤
# If the crop is greater than 1:1, will get the map item label
item-multiple-tag: "{display:{Lore:['{\"extra\":[{\"italic\":false,\"color\":\"white\",\"text\":\"%mapview.column%-%mapview.row%\"}],\"text\":\"\"}']},map:%mapview.id%}"