TagRun

TagRun is a custom-developed name-tag-tagging game plugin for the Gateway to the Past server, featuring a complete gameplay experience that includes shrinking zones, safe zones, item crates, skill vendors, and score and results displays.

Feature Overview

• Name Tag Tearing Mechanics: Back-check, distance detection, and hold duration detection
• Scoring and Settlement: Kill/Point/Elimination statistics, top three and full player data display at the end of the round
• Shrinking Circle System: Multi-stage shrinking, poison circle damage, and BossBar display
• Safe Zone: Entry/exit alerts, health regeneration, and durability repair
• Item System: Sprint Rune, Smoke Grenade, Tracking Compass, Trap Name Tag, Invisibility Cloak, Anti-Tear Totem
• Supply Box Respawn: Random respawn and restocking by zone
• Skill Merchant: Right-click to open GUI; supports purchases with points and items
• Resurrection Card: Resurrect a designated player after purchase (refunds upon failure)
• Preparation Phase: Players join with /nametag ready; administrators start the game

Quick Start

1. Place the mod and start the server to generate the configuration file
2. Set the map and zones
3. Set the event map and start the game

Setting Map Zones

Use the Zone Wand to set the main zone and item chest spawn zones:

/nametag wand
/nametag pos1
/nametag pos2
/nametag setarena <map ID>
/nametag setchest <map ID> <name>
/nametag setsafe <map ID> <name>

Set the active map and start

/nametag setactive <map ID>
/nametag prepare
/nametag ready
/nametag start

Main Commands

• /nametag wand Get the selection wand
• /nametag pos1|pos2 Set selection points
• /nametag setarena <map ID> Set the main arena
• /nametag setsafe <map ID> <name> Set the safe zone
• /nametag setchest <map ID> <name> Set the chest spawn area
• /nametag setmerchant <name> Set the skill merchant's location
• /nametag setactive <map ID> Set the active map
• /nametag prepare Start the preparation phase
• /nametag ready|unready Join/leave the preparation queue
• /nametag start|stop Start/end the game
• /nametag status View game status
• /nametag show <map ID> View map information
• /nametag save Save map configuration
• /nametag reload Reload configuration

Configuration Files

Configuration is located in config.yml, map area data is stored in maps.yml, and statistics are stored in stats.yml.

Key Configuration Excerpts

Game and Elimination Mode

game:
  countdown_seconds: 10
  elimination_mode: “spectator”  # spectator=spectator, hunter=hunter

Scoring Configuration

score:
  rip_points: 10
  streak_bonus_points: 15
  streak_bonus_eve

Translated with DeepL.com (free version)

TagRun

TagRun 是一个为 往之门服务器 定制开发的撕名牌玩法插件，包含缩圈、安全区、道具箱、技能商人、计分与结算展示等完整游戏流程。

功能概览

• 撕名牌机制：背后判定、距离判定、按住时长判定
• 计分与结算：击杀/积分/淘汰统计，局末前三与全员数据展示
• 缩圈系统：多阶段缩圈、毒圈伤害、BossBar 展示
• 安全区：进入/离开提示、安全区回血与耐久修复
• 道具系统：疾跑符文、烟雾弹、追踪罗盘、陷阱名牌、隐身斗篷、免撕图腾
• 道具箱刷新：按区域随机刷新与补货
• 技能商人：右键打开 GUI，支持积分与物品购买
• 复活卡：购买后可复活指定玩家（支持失败返还）
• 准备阶段：玩家 /nametag ready 加入，管理员开局

快速开始

1. 放入插件并启动服务器生成配置文件
2. 设置地图与区域
3. 设置活动地图并开局

设置地图区域

使用选区棒设置主区域与道具箱刷新区：

/nametag wand
/nametag pos1
/nametag pos2
/nametag setarena <地图ID>
/nametag setchest <地图ID> <名称>
/nametag setsafe <地图ID> <名称>

设置活动地图并开始

/nametag setactive <地图ID>
/nametag prepare
/nametag ready
/nametag start

主要指令

• /nametag wand 获取选区棒
• /nametag pos1|pos2 设置选区点
• /nametag setarena <地图ID> 设置主区域
• /nametag setsafe <地图ID> <名称> 设置安全区
• /nametag setchest <地图ID> <名称> 设置道具箱刷新区
• /nametag setmerchant <名称> 设置技能商人位置
• /nametag setactive <地图ID> 设置活动地图
• /nametag prepare 开启准备阶段
• /nametag ready|unready 加入/退出准备队列
• /nametag start|stop 开始/结束游戏
• /nametag status 查看游戏状态
• /nametag show <地图ID> 查看地图信息
• /nametag save 保存地图配置
• /nametag reload 重新加载配置

配置文件

配置位于 config.yml，地图区域数据保存在 maps.yml，统计数据保存在 stats.yml。

关键配置节选

游戏与淘汰模式

game:
  countdown_seconds: 10
  elimination_mode: "spectator"  # spectator=旁观者，hunter=猎人

计分配置

score:
  rip_points: 10
  streak_bonus_points: 15
  streak_bonus_every: 3
  win_points: 30

技能商人交易

merchant:
  enabled: true
  locations:
    商人1:
      name: "技能商人"
      world: "world"
      x: 0.5
      y: 64.0
      z: 0.5
      yaw: 0.0
      pitch: 0.0
  trades:
    - result:
        type: REVIVE_CARD
        amount: 1
      points: 20
    - result:
        type: SPEED_RUNE
        amount: 1
      cost:
        type: RIPPED_TAG
        amount: 1

道具箱掉落表

chest:
  enabled: true
  per_region: 4
  min_items: 1
  max_items: 3
  loot:
    - type: SPEED_RUNE
      weight: 6
      amount: 1

数据持久化

• maps.yml：地图主区域、安全区、道具箱刷新区
• stats.yml：积分、击杀、连杀、淘汰次数