🎉 NPC Police 插件介绍

NPC Police 插件为 Minecraft 服务器提供了一套完整的司法系统，包括结构化的监狱系统、基于 NPC 的警察力量、监禁系统、赏金系统以及一般的混乱威慑机制。可以帮助服务器管理者更好地管理和维护游戏秩序。

👮 功能特性

• 基础设置可在多个层级配置：服务器 (Config.yml)、世界、区域、监狱和每个 NPC。
• 可自定义赏金：基于造成的伤害、谋杀 NPC/玩家、PVP 和越狱行为。
• 可根据状态增减赏金：（通缉、入狱、越狱、在牢房中（白天/夜晚））。
• 自定义赏金与服刑时间对应关系：全局、每个世界或每个监狱！
• 可自定义消息系统：基于与活动或监狱的距离限制警报/通知。
• 设置到达每个玩家的延迟或时间，基于距离（新闻传播速度可快可慢，由您决定）。
• 定义全局、区域或每个 NPC 保护的 NPC。
• 启用 NPC 仅攻击他们能看到的目标。
• 自定义视线系统，可以透过窗户、铁栏杆、冰看到目标，基于它们的透明度。
• 能够在逮捕时没收玩家的物品栏，并提供多种归还方式。
• 能够将物品配置为违禁品，在逮捕后永远不会归还。
• 可自定义多个事件的命令：全局或每个世界：NPC 警告、警报守卫、警报（范围内没有守卫）、NPC 谋杀、玩家变为（通缉、逮捕、逃脱、释放）。
• 每个监狱可以自定义：监狱名称、多个牢房位置、每秒花费的赏金、白天或夜晚离开牢房、在监狱中、监狱内 PVP 伤害的赏金。
• 此系统还扩展了一些其他插件的功能集：
  • WorldGuard（更多标志可用于支持自定义您的世界）。
  • 设置 PVP、NPC 伤害、NPC 谋杀、越狱或通缉时间的赏金。
  • 设置 NPC 默认值（不直接覆盖 NPC 上的设置，仅在服务器或世界级别）。
  • 定义区域以在进入时自动标记玩家的状态。
  • 需要与 NPC 的视线。透明方块、玻璃等都有影响视线的级别。
  • 被标记时添加赏金。
  • 被抓住时向玩家发送消息！
• PlaceholderAPI
  • 提供多个变量以在其他地方显示。
  • 用户：赏金、总赏金。当前状态、先前状态、当前监狱名称、上次攻击/谋杀/逮捕日期或时间（hh:mm:ss）、逮捕/逃脱/谋杀次数。
  • 全局：最想要的玩家（赏金、状态、名称）、最近的监狱。
• BetonQuest
  • 提供额外的事件、目标和条件来构建更深入的任务/故事。
• LeaderHeads
  • 用户最喜欢查看谁是网络中最差或最好的罪犯（通过 MySql 或服务器通过 SQLite）。
  • 当前最高赏金、最新/最多逮捕、最新/最多逃脱、最多谋杀、最高总赏金。

🔌 依赖插件

• Vault (经济 & 权限)
• Citizens2 (NPC 交互)
• WorldGuard (监狱区域管理)
• Sentinel

🚀 快速入门教程

1. 下载插件并放入 plugins 文件夹。
2. 启动服务器，它会自动创建一个默认配置文件 (plugins/jailer/config.yml)。
3. 编辑文件并设置世界（或复制要插件运行的每个世界的默认配置）。
4. 创建一个覆盖监狱区域的 WorldGuard 区域：/region create tutorialjail
5. 创建一个监狱：/np createjail {short name} {region name} {Display Name} 例如：/np createjail tutjail tutorialjail Tutorial Jail
6. 添加牢房：站在您希望玩家被传送到的牢房位置，输入 /np addcell
7. 在监狱内或周围创建一个玩家可以从内部访问的 NPC。
8. 选择该 NPC 并输入 /np npc，点击菜单选项中的 X，它应变为对勾。此人现在接受右键单击。
9. 在监狱外创建一个 NPC。
10. 为他们装备武器。
11. 对于 Sentinel，使用以下命令：/trait sentinel
12. 输入 /np npc，选中 guard 的复选框，应显示一个对勾。
13. 选中 LOS Attack 的复选框。
14. 创建另一个 NPC 在警卫 25 个方块内攻击。
15. 攻击它，您应该会看到警告或赏金。一旦您对 NPC 造成足够的伤害，警卫应该开始攻击。
16. 在监狱中时，右键单击您在那里创建的 NPC，应该会出现一个菜单。

📍 监狱布局示例

1. 我倾向于将法官/狱卒放置在一个外部玩家和被捕玩家都可以与他们互动的位置。
2. 牢房是我用来设置玩家在被捕后将被送到的位置。
3. 创建一个逃脱的方法，我使用铁门以确保 NPC 警卫无法进入监狱（倾向于使用两扇门以确保他们不会进入监狱）。
4. 如果玩家离开监狱区域，他们将被转换为逃脱者，并且可以使用 Sentinel 或 Sentry 让警卫追捕他们。

## 👮 命令 & 权限

一般指令

• /NP Reload - 重新加载所有配置文件
  • 权限: NPCpolice.reload
• /NP AddCell - 将玩家当前位置添加到监狱的单元格列表中
  • 权限: NPCpolice.createjail
• /NP CreateJail [ShortName] [WorldGuardRegionName] [DisplayName] - 创建一个监狱
  • 权限: NPCpolice.createjail
• /NP RemoveJail [ShortName] - 删除一个监狱
  • 权限: NPCpolice.createjail
• /NP SetJailer - 将你选定的NPC设置为 Jailer（需要Citizens）
  • 权限: NPCpolice.basic
• /NP npc - 允许你配置所选NPC的许多设置。
  • 权限: NPCpolice.basic
• /NP SetBounty [Player] [Amount] - 手动设置玩家的赏金
  • 权限: NPCpolice.basic
• /NP AddBounty [Player] [Amount] - 给玩家增加赏金
  • 权限: NPCpolice.basic
• /NP TakeBounty [Player] [Amount] - 从玩家的赏金中扣除
  • 权限: NPCpolice.basic
• /NP ClearBounty [Player] - 清除玩家的赏金
  • 权限: NPCpolice.basic
• /NP Jail [Player] [JailName] - 将玩家发送到监狱
  • 权限: NPCpolice.basic
• /NP Free [Player] - 从监狱释放玩家
  • 权限: NPCpolice.basic
• /NP Status [Player] - 检查玩家的状态
  • 权限: NPCpolice.basic
• /NP Purge [Days] - 清除所有超过 X 天的脱狱玩家记录。
  • 权限: NPCpolice.admin

## ⚙️ 配置示例

Settings:
  Debug: false
  DefaultJail: ''
  PurgeDataEvery: 24
  JailEveryLogin: false
  TrackPriorStates: true
  StatusOnLogin: true
  BannedItemsKept: true
  BannedItems:
  - stick
  - dirt
  Worlds:
    Example_world:
      GlobalBounty: 10.0
      BountyOnMurderNPC: 50.0
      BountyOnDamageNPC: 0.0
      BountyOnPVP: 0.0
      BountyOnEscape: 100.0
      WantedTimer: 60
      BountyDecay: 5.0
      DecayTimer: 600
      useLos: false
      AlwaysWanted: []
      EnterRegion: []
      WorldGuard:
        Regions:
          ProtectedNPCs:
            testregion:
              NPC: []
  Jails:
    YourJail:
      displayName: YourJail
      CellLocations:
      - world:Example_world
        x: 0.0
        y: 0.0
        z: 0.0
        yaw: 0.0
        pitch: 0.0
      jailLocation:
        world: Example_world
        x: 0.0
        y: 0.0
        z: 0.0
        yaw: 0.0
        pitch: 0.0
      RegionName: YourJail
      BountyPerSecond: 1.0
      pvpBounty: 0.0
      InJail: 0.0
      OutOfCellNight: 0.0
      OutOfCellDay: 0.0
      Commands:
        Arrested: []
        Released: []
        Escaped: []
  Commands:
    NPC_Warning: []
    Guard_Alert: []
    NoGuard_Alert: []
    NPC_Murder: []
    Player_Wanted: []
    Player_Arrested: []
    Player_Escaped: []
    Player_Released: []
  Placeholders:
    Global:
      MostWantedBounty: '&6Most Wanted: &e%jailer_mostwanted_name% &7-&c %jailer_mostwanted_bounty%
        &7 Status: %jailer_mostwanted_status%'
      ClosestJail: '&6Closest Jail: &e%jailer_closestjail% '
    User:
      Bounty: '&6Current Bounty: &c%jailer_bounty%'
      TotalBounty: '&6Total All Time Bounty: &c%jailer_totalbounty%'
      CurrentStatus: '&6Current Status: &e%jailer_status%'
      PriorStatus: '&6Prior Status: &e%jailer_priorstatus%'
      CurrentJail: '&6Current Jail: &e%jailer_jailname%'
      LastAssault: '&6Last Assaulted Someone: &e%jailer_lastassault%'
      LastMurder: '&6Last Murdered Someone: &e%jailer_lastmurder%'
      LastArrested: '&6Last Arrested: &e%jailer_lastarrested%'
      TimesArrested: '&6Times Arrested: &e%jailer_arrestedcount%'
      TimesEscaped: '&6Times Escaped: &e%jailer_escapecount%'
      TimesMurdered: '&6Times Murdered: &e%jailer_murdercount%'
  Messages:
    Prefix: '&7[&6NPC Police&7]'
    arrested: '&6%player% &7was arrested!'
    escaped: '&6%player% &7has escaped!'
    released: '&6%player% &7has been released!'
    wanted: '&6%player% &7is now wanted!'
    JailerGreeting: '&6Hello! &7Right Click to see options'

🎉 享受插件！ * 此插件使用插件 Metrics 系统。如果要禁用它，请打开 /PluginMetrics/Config.yml 并将 opt-out 设置为 true。