原创 LSE PKSystem-完善的网游红名罪恶值系统丨红名机制丨GUI管理丨排行榜丨死亡物品掉落丨安全区丨 2.0

 {
    "PKValue": {
        "killPlayerPKValue": 100,        // 击杀玩家增加的罪恶值
        "killRedNamePKValue": 50,        // 击杀红名玩家增加的罪恶值（较少）
        "redNameThreshold": 100,         // 达到此罪恶值成为红名
        "maxPKValue": 1000,              // 最大罪恶值
        "decayInterval": 60000,          // 罪恶值衰减间隔（毫秒）
        "decayAmount": 1,                // 每次衰减的罪恶值
        "decayRequireOnline": true,      // 是否需要在线才衰减
        "deathReduceEnabled": true,      // 是否启用死亡减少罪恶值
        "deathReduceMode": "percentage", // 死亡减少模式: "percentage"=百分比, "fixed"=固定数值
        "deathReducePercentage": 0.05,   // 死亡减少罪恶值百分比（0.05=5%）
        "deathReduceFixed": 10,          // 死亡减少固定罪恶值数量
        "deathReduceMin": 1,             // 最小减少数量
        "deathReduceMax": 50,            // 最大减少数量
        "deathReduceOnlyPositive": true  // 只有罪恶值大于0时才减少
    },
    "RedName": {
        "showTitle": true,               // 是否显示Title提示
        "titleDuration": 70,             // Title显示时长（Tick）
        "broadcastOnKill": true,         // 击杀时是否全服公告
        "broadcastOnRedName": true       // 成为红名时是否全服公告
    },
    "GUI": {
        "enabled": true,              
        "rankListSize": 10               // 排行榜显示数量
    },
    "DeathDrop": {
        "enabled": true,                 // 是否启用红名死亡掉落经济
        "mode": "rate",                  // 掉落模式: "rate"=比例, "fixed"=固定数值
        "dropMoneyRate": 0.05,           // 掉落金币比例（0.1=10%）
        "dropMoneyFixed": 100,           // 固定掉落金币数量
        "dropEquipment": false,          // 是否掉落物品
        "dropEquipmentRate": 0.3         // 物品掉落概率
    },
    "Rewards": {
        "enabled": true,                 // 是否启用击杀奖励
        "killRedNameReward": true,       // 击杀红名是否有奖励
        "rewardMoney": 100,              // 击杀红名奖励金币
        "rewardItems": [                 // 击杀红名奖励物品
            {
                "type": "minecraft:diamond",
                "count": 1,
                "chance": 0.5
            }
        ]
    },
    "SafeZone": {
        "enabled": true,                 // 是否启用安全区域保护
        "safeZones": [],                 // 安全区域坐标 [{name,x1,y1,z1,x2,y2,z2,dimId}]
        "protectItems": true,            // 是否保护物品掉落
        "protectMoney": true,            // 是否保护金币掉落
        "protectionMessage": "你在安全区域内死亡，物品和金币已受到保护！" // 自定义保护消息
    }
}

const getPKValue = ll.imports("PKSystem", "getPKValue")
const setPKValue = ll.imports("PKSystem", "setPKValue")
const isRedName = ll.imports("PKSystem", "isRedName")

const playerXuid = "1234567890"
const currentPK = getPKValue(playerXuid)        // 获取罪恶值
const isRed = isRedName(playerXuid)             // 检查是否红名
setPKValue(playerXuid, 150)                     // 设置罪恶值

const getPKValue = ll.imports("PKSystem", "getPKValue")
const pkValue = getPKValue(xuid)

const setPKValue = ll.imports("PKSystem", "setPKValue")
const success = setPKValue(xuid, value)

const addPKValue = ll.imports("PKSystem", "addPKValue")
const newPK = addPKValue(xuid, amount)

const reducePKValue = ll.imports("PKSystem", "reducePKValue")
const newPK = reducePKValue(xuid, amount)

const isRedName = ll.imports("PKSystem", "isRedName")
const redNameStatus = isRedName(xuid)

const getRedNameThreshold = ll.imports("PKSystem", "getRedNameThreshold")
const threshold = getRedNameThreshold()

const getPlayerData = ll.imports("PKSystem", "getPlayerData")
const playerInfo = getPlayerData(xuid)

{
      pkValue: 100,           // 当前罪恶值
      lastKillTime: 1640995200000, // 最后击杀时间戳
      killCount: 15,          // 总击杀数
      deathCount: 8,          // 死亡次数
      redNameTime: 1640995200000, // 成为红名的时间戳
      isRedName: true,        // 是否为红名
      name: "PlayerName"      // 玩家名称
  }

const getKillHistory = ll.imports("PKSystem", "getKillHistory")
const history = getKillHistory(xuid, limit)

 [
      {
          victim: "VictimName",    // 被击杀者名称
          time: 1640995200000,     // 击杀时间戳
          pkIncrease: 100          // 此次击杀增加的罪恶值
      }
  ]

const getPlayerStats = ll.imports("PKSystem", "getPlayerStats")
const stats = getPlayerStats(xuid)

 {
      pkValue: 100,        // 当前罪恶值
      killCount: 15,       // 击杀数
      deathCount: 8,       // 死亡数
      isRedName: true,     // 是否红名
      kdr: "1.88"         // 击杀死亡比 (字符串格式)
  }

const getPKRankList = ll.imports("PKSystem", "getPKRankList")
const rankList = getPKRankList(limit)

 [
      {
          xuid: "1234567890",     // 玩家XUID
          name: "PlayerName",     // 玩家名称
          pkValue: 500,           // 罪恶值
          killCount: 25,          // 击杀数
          isRedName: true         // 是否红名
      }
  ]

const getRedNameList = ll.imports("PKSystem", "getRedNameList")
const redNamePlayers = getRedNameList()

 [
      {
          xuid: "1234567890",         // 玩家XUID
          name: "PlayerName",         // 玩家名称
          pkValue: 500,               // 罪恶值
          killCount: 25,              // 击杀数
          redNameTime: 1640995200000  // 成为红名的时间戳
      }
  ]

const getConfig = ll.imports("PKSystem", "getConfig")
const config = getConfig()

 {
      PKValue: {
          killPlayerPKValue: 100,      // 击杀玩家增加罪恶值
          killRedNamePKValue: 50,      // 击杀红名增加罪恶值
          redNameThreshold: 100,       // 红名阈值
          maxPKValue: 1000,            // 最大罪恶值
          decayInterval: 60000,        // 衰减间隔
          decayAmount: 1,              // 衰减数量
          deathReduceEnabled: true,    // 启用死亡减少
          deathReduceMode: "percentage", // 减少模式
          deathReducePercentage: 0.05, // 减少百分比
          deathReduceFixed: 10,        // 固定减少数量
          deathReduceMin: 1,           // 最小减少
          deathReduceMax: 50,          // 最大减少
          deathReduceOnlyPositive: true // 只减少正值
      },
      RedName: {
          showTitle: true,             // 显示Title
          titleDuration: 70,           // Title时长
          broadcastOnKill: true,       // 击杀公告
          broadcastOnRedName: true     // 红名公告
      },
      DeathDrop: {
          enabled: true,               // 启用死亡掉落
          mode: "rate",                // 掉落模式
          dropMoneyRate: 0.05,         // 金币掉落比例
          dropMoneyFixed: 100,         // 固定掉落金币
          dropEquipment: false,        // 掉落装备
          dropEquipmentRate: 0.3       // 装备掉落概率
      },
      Rewards: {
          enabled: true,               // 启用奖励
          killRedNameReward: true,     // 击杀红名奖励
          rewardMoney: 100,            // 奖励金币
          rewardItems: []              // 奖励物品
      },
      SafeZone: {
          enabled: true,               // 启用安全区域
          safeZones: [],               // 安全区域列表
          protectItems: true,          // 保护物品
          protectMoney: true,          // 保护金币
          protectionMessage: "..."     // 保护消息
      }
  }

const updateConfig = ll.imports("PKSystem", "updateConfig")
const success = updateConfig(newConfig)
```

// 只更新罪恶值相关配置
  updateConfig({
      PKValue: {
          killPlayerPKValue: 150,
          redNameThreshold: 120
      }
  })
  ```

const formatPKValue = ll.imports("PKSystem", "formatPKValue")
const formattedValue = formatPKValue(pkValue)
```

const formatPlayerStatus = ll.imports("PKSystem", "formatPlayerStatus")
const status = formatPlayerStatus(xuid)
```

const isPlayerInSafeZone = ll.imports("PKSystem", "isPlayerInSafeZone")
const inSafeZone = isPlayerInSafeZone(player)
```

const getSafeZones = ll.imports("PKSystem", "getSafeZones")
const safeZones = getSafeZones()
```

 [
      {
          name: "出生点安全区",      // 区域名称
          x1: 100, y1: 60, z1: 100, // 区域坐标1
          x2: 200, y2: 120, z2: 200, // 区域坐标2
          dimId: 0                   // 维度ID
      }
  ]
  ```

const addSafeZone = ll.imports("PKSystem", "addSafeZone")
const success = addSafeZone(safeZone)
```

  {
      name: "新安全区",
      x1: 100, y1: 60, z1: 100,
      x2: 200, y2: 120, z2: 200,
      dimId: 0
  }
  ```

const giveKillRedNameReward = ll.imports("PKSystem", "giveKillRedNameReward")
giveKillRedNameReward(killer)
```

const handleRedNameDeathDropMoney = ll.imports("PKSystem", "handleRedNameDeathDropMoney")
handleRedNameDeathDropMoney(player)
```

const handleRedNameEquipmentDrop = ll.imports("PKSystem", "handleRedNameEquipmentDrop")
handleRedNameEquipmentDrop(player)
```

const getVersion = ll.imports("PKSystem", "getVersion")
const version = getVersion()
```

const getPluginName = ll.imports("PKSystem", "getPluginName")
const name = getPluginName()
```

// 导入所需的API
const getPKValue = ll.imports("PKSystem", "getPKValue")
const getPlayerStats = ll.imports("PKSystem", "getPlayerStats")
const getPKRankList = ll.imports("PKSystem", "getPKRankList")
const isRedName = ll.imports("PKSystem", "isRedName")
// 注册查看PK信息命令
mc.regPlayerCmd("pkinfo", "查看PK信息", (player, args) => {
    const xuid = player.xuid
    const stats = getPlayerStats(xuid)
 
    if (stats) {
        const status = isRedName(xuid) ? "§c红名" : "§a白名"
        player.tell(`§6=== 你的PK信息 ===`)
        player.tell(`§e罪恶值: §f${stats.pkValue}`)
        player.tell(`§e状态: ${status}`)
        player.tell(`§e击杀数: §f${stats.killCount}`)
        player.tell(`§e死亡数: §f${stats.deathCount}`)
        player.tell(`§e击杀比: §f${stats.kdr}`)
    } else {
        player.tell("§c无法获取PK信息")
    }
})
// 注册PK排行榜命令
mc.regPlayerCmd("pkrank", "查看PK排行榜", (player, args) => {
    const rankList = getPKRankList(10)
 
    player.tell("§6=== PK排行榜 (前10名) ===")
    rankList.forEach((entry, index) => {
        const rank = index + 1
        const status = entry.isRedName ? "§c红名" : "§a白名"
        player.tell(`§e${rank}. §f${entry.name} §7- §f${entry.pkValue}PK ${status}`)
    })
})
// 监听玩家PK值变化
const originalSetPKValue = ll.imports("PKSystem", "setPKValue")
function monitorPKChange(xuid, newValue) {
    const result = originalSetPKValue(xuid, newValue)
 
    // 记录PK值变化日志
    const player = mc.getPlayer(xuid)
    if (player) {
        log(`玩家 ${player.realName} 的PK值变更为: ${result}`)
    }
 
    return result
}