特征
- 允许具有权限的玩家就地移动和旋转实体
- 允许使用可配置的规则集限制功能
滥用警告
如果将权限授予普通玩家,则此插件可能会被滥用,因此建议仅将权限授予受信任的管理员或版主。性能警告
此插件会降低服务器性能,尤其是当多个玩家同时移动实体时,因此建议您谨慎使用此插件。权限
- telekinesis.admin-- 允许不受限制地使用该命令。tls
- telekinesis.ruleset.restricted-- 允许限制命令的使用。限制由插件配置控制。tls
用法
- 运行命令以获取您正在查看的实体。该实体将自动移动到您的玩家摄像机所在的位置。tls
- 按主要攻击 () 或次要攻击 () 来移动或旋转实体(取决于激活的模式)。mouse1mouse2
- 在移动或旋转实体时,按住 () 可缓慢移动/旋转,或按住 () 可快速移动/旋转。duckCtrlsprintShift
- 按 键可在模式之间切换。按住 > 按下将以相反的顺序更改模式。有关每种模式的详细信息,请参阅下文。reloadsprintreload
- 再次运行该命令以释放实体。tls
- 运行命令以重置您当前控制的实体的位置/旋转,或重置您控制的最后一个实体。tls undo
模式
- “Move away/toward” (移开/移向) -- 将实体从您身边移开或朝向您,朝您正在看的方向移动。
- “Move up/down” -- 使用世界 Y 轴向上或向下移动实体,而不管您正在查看何处,也无论实体的旋转如何。
- “Rotate around X axis (pitch)”(围绕 X 轴旋转(俯仰)) -- 围绕实体自己的 X 轴旋转实体。这基本上会使其向前或向后倾斜。
- “Rotate around Y axis (yaw)”(围绕 Y 轴旋转 (偏航)) -- 围绕实体自己的 Y 轴旋转实体。这基本上是向左或向右转动。
- “Rotate around Z axis (roll)”(围绕 Z 轴旋转 (滚动)) -- 围绕实体自己的 Z 轴旋转实体。这基本上是向左或向右倾斜。
命令
此插件使用相同的语法提供聊天和控制台命令。在聊天中使用命令时,请为其添加正斜杠前缀: '/'。- tls-- 抓取您正在查看的实体,或释放您当前正在控制的实体。
- tls undo-- 将最近抓取的实体重置为其原始位置和旋转。只有在过去 5 分钟内移动或旋转了实体,才能执行此操作。
配置
默认配置:
- Enable message prefix-- 启用或禁用 chat/console 消息前缀。前缀本身可以在本地化中配置。
- Idle timeout (seconds)-- 确定在自动释放所控制的实体之前,您可以处于非活动状态 (无实体移动或旋转) 的时间。
- Building privilege check frequency (seconds)-- 确定在使用不允许在构建被阻止时使用的规则集时检查构建权限的频率。注意:构建权限检查对服务器性能的开销很大,因此应避免将此值设置得太低。
- Move sensitivity-- 确定在使用 “Move away/toward” 或 “Move up/down” 模式时移动持有的实体的速度。这些设置不会影响您移动玩家或更改视角时实体的移动速度。
- Slow-- 在按住键时应用 ( 默认)。duckCtrl
- Normal-- 在不按住 或 键时应用。sprintduck
- Fast-- 在按住键时应用 ( 默认)。sprintShift
- Rotate sensitivity-- 确定在使用任何旋转模式时旋转持有的实体的速度。
- Rulesets-- 可以通过权限将规则集分配给玩家,以限制其使用。
- Permission suffix-- 确定与规则集关联的权限,该权限将使用格式 生成。telekinesis.ruleset.<suffix>
- Can move players (true/false) -- 确定是否允许具有此规则集的玩家移动其他玩家 (睡眠或唤醒)。
- Can use while building blocked (true/false) -- 确定是否允许具有此规则集的玩家在建筑物被阻挡时(即,当他们靠近敌方 TC 时)移动实体。
- Requires ownership (true/false) -- 确定具有此规则集的玩家是否必须拥有他们想要移动的实体。
- Max distance-- 确定具有此规则集的玩家可以拾取和移动实体的距离。这适用于尝试拾取实体时,以及使用 “Move away/toward” 和 “Move up/down” 模式时。
地方化
开发人员 API
API_IsBeingControlled
bool API_IsBeingControlled(BaseEntity entity)如果实体正在使用 Telekinesis 控制,则返回 ,否则返回 。truefalse
API_IsUsingTelekinesis
bool API_IsUsingTelekinesis(BasePlayer player)如果玩家正在使用 Telekinesis 控制 entiy,则返回 ,否则返回 。truefalse
API_StartAdminTelekinesis
bool API_StartAdminTelekinesis(BasePlayer player, BaseEntity entity)为指定的玩家和实体启动 Telekinesis 会话,没有任何限制。这与玩家对实体拥有 and 使用命令相同。如果会话能够启动,则返回 ,否则返回 。telekinesis.admintlstruefalse
退货的可能原因 :false
- 该实体已经被 Telekinesis 控制。
- 玩家已经用 Telekinesis 控制了一个实体。
- 另一个插件用钩子阻止了它。CanStartTelekinesis
API_StopPlayerTelekinesis
void API_StopPlayerTelekinesis(BasePlayer player)停止指定玩家的 Telekinesis 会话。如果玩家没有使用 Telekinesis,则没有效果。
API_StopTargetTelekinesis
void API_StopTargetTelekinesis(BaseEntity target)停止指定目标实体的 Telewonsis 会话。如果实体未被 Telenevosis 控制,则无效。
开发人员 Hook
OnTelekinesisFindFailed
- 在 Telekinesis 找不到玩家正在寻找的任何实体后调用
- 返回 a 将导致 Telekinesis 抓取该实体。BaseEntity
- 返回将导致默认行为。null
- 这对于特定插件提供没有碰撞器的实体非常有用。
OnTelekinesis开始
- 在 Telekinesis 找到目标实体后,在会话开始之前调用。
- 返回 a 将导致 Telekinesis 抓取该实体,而不是找到的实体。BaseEntity
- 返回将使用 Telekinesis 找到的实体,或者其他插件提供的实体。null
- 这对于交换将要控制的实体非常有用。例如,控制父实体而不是子实体。
CanStart心灵感应
- 在 Telekinesis 会话即将启动时调用。
- 返回 或 a 将阻止 Telekinesis 会话启动。如果返回 ,则该值将作为聊天消息发送给玩家。falsestringstring
- 返回将允许会话启动,除非其他插件阻止它。null
OnTelekinesisStarted
- 在 Telekinesis 会话开始后调用。
- 无 return 行为。
OnTelekinesisStopped
- 在 Telekinesis 会话结束后调用。
- 无 return 行为。