Overview
Anti PvE Griefing – The Ultimate Protection for Your PvE Server ✨
Are your players tired of their property being damaged, their eggs stolen, or their gameplay simply ruined by others on your server? The Anti PvE Griefing plugin is the perfect solution. It protects your players from the most common forms of griefing on PvE servers. 🛡️
Key Features
- Inventory Protection 🔒
Prevents other tribes from viewing the inventory of dead bodies and bags. This completely eliminates item theft after a player's death.
- Structure Control ⚙️
Ensures that only the structure owner can turn on or off important structures like generators, fabricators, and more.
- Dino Mating Control 🚫
Stops dinosaurs from different tribes from mating, preventing unwanted breeding and potential conflicts.
- Player Interaction 🤝
Disables the ability for other players to drag and carry your players or dinos.
- Item & Egg Pickup 🥚
Prevents unauthorized players from picking up dropped items and fertilized eggs belonging to other tribes.
- Decayed Dinos 💀
Automatically destroys decayed dinos instead of allowing them to be unclaimed, preventing other players from taking over your territory.
- Structure Settings 🔑
Provides fine-grained control over unlocked or PIN-coded structures.
- Automatic Unlocking 🔓
Automatically unlocks specific structures to prevent them from being locked accidentally.
- Offline Player Protection 😴
A customizable timer protects players and their property while they are offline.
- Auto-destroy Eggs 💥
Allows you to automatically destroy fertilized eggs using a whitelist or blacklist to help control dino population.
- Item Pickup Modes 📦
Flexible modes allow you to customize item pickup rules: BlockAll, BlockAllExcept, or AllowAllExcept.
- Algae Protection 🌿
Prevents other players from harvesting algae from your Archelon's algae collection.
Installation & Requirements
System Requirements
To run AntiPVEGriefing, you need:
- Game: ARK: Survival Ascended Server (ASA)
- API: AsaApi v1.19 or newer.
- Dependencies: Visual C++ Redistributable packages 2015–2022
Installation Steps
- Installation: Copy the plugin folder to your server's directory:
../ShooterGame/Binaries/Win64/ArkApi/Plugins/
- Configuration Files: In the plugin folder, you will find two files:
config.json: This is the main configuration file that you will edit.config_help.json: A supplementary file with example settings and detailed comments.
- Editing: Edit the
config.json file using any text editor of your choice.
- Applying Settings:
- After the initial editing, restart your server to load your new settings.
- For all subsequent changes, use the
APG.Reload command (via RCON) or cheat APGReloadConfig (in the in-game console). This will apply the new settings without a server restart.
Patch Notes
✨ Update 3.1
- The parameter name in config.json has been fixed - CheckUnlockStateAfterRestart. You need to open config.json and change the old name CheckUnlockStateAfterReatart to the new CheckUnlockStateAfterRestart.
- Removed APG_Documentation.txt and APG_Commands.txt. All docs now in new html file - APG_Documentation.html
✨ Update 3.0
- Reworked config.json - now more logical and structured.
- New Docs folder - includes full documentation. Inside you'll find a detailed guide (APG_Documentation.txt) and a complete command list (APG_Commands.txt).
- A lot of fixes for offline protection - better logic for protecting players who log out.
- Special structure inventory access - inventories of structures in SpecialStructureSettings section will always be accessible if the structure is unlocked, regardless of other settings.
- Fixed mating at high mating rates - attackers can no longer obtain eggs at high mating rates (tested with x50, x100); mating is now reliably blocked.
- Reworked item pickup protection - now supports new flexible modes: BlockAll, BlockAllExcept, AllowAllExcept (more info in config_help.json or doc file).
- New parameter: BlockAlgaeCollectingFromOthersArchelon - prevents players from harvesting Algae from other people's Archelons.
- Updated discord docs channel: 📝documentation
Admin Commands
A complete list of all available commands and their descriptions is below. These commands can only be used by server admins (via RCON or the in-game console using the `cheat` prefix)[cite: 110, 111].
Console Commands (In-Game)
- **APGReloadConfig**
Description: Reloads the plugin's configuration file without needing to restart the server[cite: 112].
Usage: cheat APGReloadConfig [cite: 113]
- **GetTargetBP**
Description: Prints the blueprint path of the targeted structure or dinosaur[cite: 113].
Usage: cheat GetTargetBP [cite: 115]
- **GetItemsBP**
Description: Prints the blueprint paths of all items in the admin's inventory[cite: 115].
Usage: cheat GetItemsBP [cite: 117]
- **KillTarget**
Description: Kills the targeted player[cite: 117].
Usage: cheat KillTarget [cite: 118]
RCON Commands (External Tool)
General Configuration
All plugin parameters are configured in the config.json file. General settings controlling the plugin's basic behavior[cite: 70, 71].
OverrideConfigPath string
This parameter allows you to specify a custom path to the configuration file[cite: 72]. If this field is filled, the plugin will ignore the settings in config.json and load them from the specified file[cite: 73]. To use the standard file, leave this field empty ("")[cite: 74].
AdminsIgnoreProtection boolean
If set to "true", server administrators will be able to ignore all protection rules set by the plugin[cite: 75].
Player Protection
Settings related to protecting players from friendly fire, unintentional damage, and targeted actions by other players[cite: 76, 78, 81].
OfflineProtection (object)
Settings for protecting players who have logged off[cite: 76].
Enable boolean
"true" enables immunity to damage for offline players[cite: 76].
DeactivateAfterLoginInSeconds number
Specifies how many seconds after a player logs in that their damage protection will be disabled[cite: 77].
GrabOtherPlayers (object)
Settings to prevent players from grabbing other players[cite: 78].
Disable boolean
"true" prevents players from grabbing characters from other tribes[cite: 79].
AllowAllies boolean
"true" allows grabbing characters only for members of allied tribes (alliances)[cite: 80].
DinoCarry (object)
Settings to prevent dinosaurs with riders from grabbing other players[cite: 81].
Disable boolean
"true" prevents a ridden dino from grabbing players from other tribes[cite: 82].
AllowAllies boolean
"true" allows this only for members of allied tribes (alliances)[cite: 83].
Structures & Items Protection
Settings for protecting structures and preventing non-tribe members from interacting with items or causing damage[cite: 84, 89, 91, 93].
PreventItemPickup (object)
Settings to prevent item pickup[cite: 84].
Enable boolean
"true" enables the item pickup prevention feature[cite: 84].
AllowAllies boolean
"true" allows tribe members and alliance members to pick up items[cite: 84].
Mode string
Defines the operational mode of the feature[cite: 85]. Possible values:
- "BlockAll": Blocks the pickup of all items[cite: 85].
- "BlockAllExcept": Blocks all items except those listed in
ItemWhitelist[cite: 86].
- "AllowAllExcept": Allows the pickup of all items except those listed in
ItemBlacklist[cite: 86].
ItemWhitelist array
A list of item class that can be picked up in "BlockAllExcept" mode[cite: 87].
ItemBlacklist array
A list of item class that cannot be picked up in "AllowAllExcept" mode[cite: 88].
PreventFertilizedEggPickup (object)
Settings to prevent picking up fertilized eggs[cite: 89].
Enable boolean
"true" enables the prohibition of picking up fertilized eggs[cite: 89].
AllowAllies boolean
"true" allows alliance members to pick up eggs[cite: 90].
StructureInteraction (object)
Settings for interacting with structures[cite: 91].
DisableTurnOnOff boolean
"true" prevents players from turning other tribes' structures on/off[cite: 91].
AllowAllies boolean
"true" allows this for tribe and alliance members[cite: 92].
AllowUnlockedStructures boolean
"true" allows interaction with unlocked structures[cite: 92].
InventoryView (object)
Settings for viewing other players' inventories[cite: 93].
DisableOtherInventoriesView boolean
"true" prevents viewing the inventories of other tribes' structures, players, corpses, bags, etc.[cite: 93].
IgnoreStructuresWithPIN boolean
"true" allows viewing inventories in structures with a set PIN code[cite: 93].
IgnoreUnlockedStructures boolean
"true" allows viewing inventories in unlocked structures[cite: 94].
AllowAllies boolean
"true" allows alliance members to view inventories[cite: 94].
Dino Management
Configuration for protecting tamed and wild dinosaurs from damage and unwanted interactions[cite: 95, 97, 99].
BlockAlgaeCollectingFromOthersArchelon boolean
If "true", prevents players from other tribes from collecting Algae from your Archelon[cite: 95].
AllowAlliesAlgaeCollecting boolean
If "true", allows members of allied tribes (alliances) to collect Algae from your Archelon, even if the primary block is enabled[cite: 96].
DestroyDecayedDinos boolean
"true" enables the automatic destruction of dinosaurs that have reached their decay timer[cite: 97]. **IMPORTANT:** This function only works if dino decay is enabled on the server[cite: 98].
DisableDinoMating boolean
"true" prevents dinosaur mating between different tribes[cite: 99].
AllowAlliesDinoMating boolean
"true" allows dinosaur mating between allied tribes[cite: 99].
Eggs Management
Specific rules for protecting eggs from theft or destruction, a common form of PvE griefing[cite: 100].
AutoDestroyFertilizedEggs boolean
"true" automatically destroys fertilized eggs that have been dropped on the map. This helps keep the map clean[cite: 100].
AutoDestroyEggsDelayInSeconds number
The delay in seconds before an egg is destroyed[cite: 101].
EggsTypeToDestroy array
A list of fertilized egg Blueprint paths (e.g., "Wyvern") that will be automatically destroyed[cite: 102].
StructuresPreventingDestruction array
A list of structure Blueprint paths. An egg will not be destroyed if it is within a radius of approximately 7 foundations from any of these structures[cite: 103].
Special Structures Settings
In this section, you can set up special rules for any specific structures using their Blueprint paths[cite: 104]. You can add an unlimited number of structures[cite: 104].
Example Structure: Oil Pump
Blueprint'/Game/ScorchedEarth/Structures/OilPump/OilPump.OilPump' object
Settings for an Oil Pump (used as an example)[cite: 105].
UnlockOnPlacement boolean
"true" automatically unlocks the structure immediately after it is placed[cite: 106].
SupportLocking boolean
"false" prevents the structure from being locked (including PIN-codes)[cite: 107].
CheckUnlockStateAfterRestart boolean
"true" checks the lock state after a server restart and automatically unlocks the structure if it was locked[cite: 107].
Example Structure: Tree Sap Tap
Blueprint'/Game/PrimalEarth/Structures/BuildingBases/TreeSapTap_SM.TreeSapTap_SM' object
Settings for a Tree Sap Tap (used as an example).
UnlockOnPlacement: true, SupportLocking: false, CheckUnlockStateAfterRestart: true
Support & Donate
Support the Project
If you enjoy this plugin and would like to show your appreciation or support my work, you can do so via the links below.
If you found a bug or need help, join my Discord server.
Descripción General
Anti PvE Griefing – La protección definitiva para tu servidor PvE ✨
¿Tus jugadores están cansados de que sus propiedades sean dañadas, sus huevos robados o su experiencia arruinada por otros en tu servidor? El plugin Anti PvE Griefing es la solución perfecta. Protege a tus jugadores de las formas más comunes de griefing en servidores PvE. 🛡️
Características clave
- Protección de Inventario 🔒
Impide que otras tribus vean el inventario de cadáveres y bolsas. Elimina por completo el robo de objetos tras la muerte de un jugador.
- Control de Estructuras ⚙️
Asegura que sólo el propietario pueda encender o apagar estructuras importantes como generadores, fabricadores y más.
- Control de Apareamiento de Dinos 🚫
Evita el apareamiento entre tribus diferentes, previniendo crías no deseadas y conflictos.
- Interacción entre Jugadores 🤝
Deshabilita la posibilidad de arrastrar y cargar a tus jugadores o dinos.
- Recogida de Objetos y Huevos 🥚
Impide que jugadores no autorizados recojan objetos caídos y huevos fertilizados de otras tribus.
- Dinos en Descomposición 💀
Destruye automáticamente los dinos en descomposición en lugar de dejarlos como "unclaimed", evitando que otros tomen tu territorio.
- Ajustes de Estructuras 🔑
Control detallado sobre estructuras desbloqueadas o con PIN.
- Desbloqueo Automático 🔓
Desbloquea automáticamente estructuras específicas para evitar bloqueos accidentales.
- Protección de Jugadores Offline 😴
Un temporizador configurable protege a los jugadores y su propiedad mientras están fuera de línea.
- Auto-destruir Huevos 💥
Permite destruir automáticamente huevos fertilizados usando listas blanca/negra para controlar la población.
- Modos de Recogida 📦
Modos flexibles: BlockAll, BlockAllExcept o AllowAllExcept.
- Protección de Algas 🌿
Evita que otros recolecten algas del recolector de tu Archelon.
Instalación y Requisitos
Requisitos del Sistema
Para ejecutar AntiPVEGriefing, necesita:
- Juego: ARK: Survival Ascended Server (ASA)
- API: AsaApi v1.19 o superior.
- Dependencias: Paquetes redistribuibles estándar de C++ (p. ej., Visual C++ Redistributable 2015-2022).
Pasos de Instalación
- Instalación: Copia la carpeta del plugin a la carpeta del servidor:
../ShooterGame/Binaries/Win64/ArkApi/Plugins/
- Archivos de configuración:
config.json: Archivo principal de configuración.config_help.json: Ejemplos y comentarios detallados.
- Edición: Edita
config.json con tu editor preferido.
- Aplicar configuración:
- Tras la primera edición, reinicia el servidor.
- Para cambios posteriores usa
APG.Reload (RCON) o APGReloadConfig (consola in‑game).
Notas de Parche
✨ Actualización 3.1
- El nombre del parámetro en config.json ha sido corregido - CheckUnlockStateAfterRestart. Debes abrir config.json y cambiar el nombre antiguo CheckUnlockStateAfterReatart al nuevo CheckUnlockStateAfterRestart.
- Eliminados APG_Documentation.txt y APG_Commands.txt. Toda la documentación ahora en el nuevo archivo html - APG_Documentation.html
✨ Actualización 3.0
- Reestructurado config.json - ahora más lógico y organizado.
- Nueva carpeta Docs - incluye documentación completa. Dentro encontrarás una guía detallada (APG_Documentation.txt) y una lista completa de comandos (APG_Commands.txt).
- Muchas correcciones para la protección offline - mejor lógica para proteger a los jugadores que se desconectan.
- Acceso a inventarios de estructuras especiales - los inventarios de las estructuras en la sección SpecialStructureSettings siempre serán accesibles si la estructura está desbloqueada, independientemente de otras configuraciones.
- Corregido apareamiento a altas tasas de apareamiento - los atacantes ya no pueden obtener huevos a altas tasas de apareamiento (probado con x50, x100); el apareamiento ahora se bloquea de manera confiable.
- Reestructurada protección de recogida de items - ahora soporta nuevos modos flexibles: BlockAll, BlockAllExcept, AllowAllExcept (más info en config_help.json o archivo doc).
- Nuevo parámetro: BlockAlgaeCollectingFromOthersArchelon - previene que los jugadores recolecten Algas de los Archelons de otros.
- Actualizado canal de docs de discord: 📝documentation
Comandos de Administrador
A continuación se muestra una lista completa de todos los comandos disponibles y sus descripciones. Estos comandos solo pueden ser utilizados por administradores del servidor (a través de RCON o la consola dentro del juego usando el prefijo `cheat`)[cite: 110, 111].
Comandos de Consola (Dentro del Juego)
- **APGReloadConfig**
Descripción: Recarga el archivo de configuración del plugin sin necesidad de reiniciar el servidor[cite: 112].
Uso: cheat APGReloadConfig [cite: 113]
- **GetTargetBP**
Descripción: Imprime la ruta Blueprint de la estructura o dinosaurio objetivo[cite: 113].
Uso: cheat GetTargetBP [cite: 115]
- **GetItemsBP**
Descripción: Imprime las rutas Blueprint de todos los objetos en el inventario del administrador[cite: 115].
Uso: cheat GetItemsBP [cite: 117]
- **KillTarget**
Descripción: Mata al jugador objetivo[cite: 117].
Uso: cheat KillTarget [cite: 118]
Comandos RCON (Herramienta Externa)
Configuración General
Todos los parámetros del plugin se configuran en el archivo config.json. Configuraciones generales que controlan el comportamiento básico del plugin[cite: 70, 71].
OverrideConfigPath cadena
Este parámetro permite especificar una ruta personalizada al archivo de configuración[cite: 72]. Si este campo está rellenado, el plugin ignorará la configuración en config.json y cargará desde el archivo especificado[cite: 73]. Para usar el archivo estándar, deja este campo vacío ("")[cite: 74].
AdminsIgnoreProtection booleano
Si está en "true", los administradores del servidor podrán ignorar todas las reglas de protección establecidas por el plugin[cite: 75].
Protección del Jugador
Configuraciones relacionadas con la protección de jugadores contra fuego amigo, daño no intencional y acciones dirigidas por otros jugadores[cite: 76, 78, 81].
OfflineProtection (objeto)
Configuraciones para proteger a los jugadores desconectados[cite: 76].
Enable booleano
"true" habilita inmunidad al daño para jugadores desconectados[cite: 76].
DeactivateAfterLoginInSeconds número
Especifica cuántos segundos después de iniciar sesión se desactiva la protección contra daño[cite: 77].
GrabOtherPlayers (objeto)
Configuraciones para evitar que los jugadores puedan agarrar a otros jugadores[cite: 78].
Disable booleano
"true" evita que los jugadores puedan agarrar personajes de otras tribus[cite: 79].
AllowAllies booleano
"true" permite agarrar personajes solo para miembros de tribus aliadas (alianzas)[cite: 80].
DinoCarry (objeto)
Configuraciones para evitar que los dinosaurios montados puedan agarrar a otros jugadores[cite: 81].
Disable booleano
"true" evita que un dino montado agarre jugadores de otras tribus[cite: 82].
AllowAllies booleano
"true" permite esto solo para miembros de tribus aliadas (alianzas)[cite: 83].
Protección de Estructuras y Objetos
Configuraciones para proteger estructuras y evitar que miembros no tribales interactúen con objetos o causen daño[cite: 84, 89, 91, 93].
PreventItemPickup (objeto)
Configuraciones para evitar la recogida de objetos[cite: 84].
Enable booleano
"true" habilita la función de prevención de recogida de objetos[cite: 84].
AllowAllies booleano
"true" permite que miembros de la tribu y la alianza recojan objetos[cite: 84].
Mode cadena
Define el modo operativo de la función[cite: 85]. Valores posibles:
- "BlockAll": Bloquea la recogida de todos los objetos[cite: 85].
- "BlockAllExcept": Bloquea todos los objetos excepto los listados en
ItemWhitelist[cite: 86].
- "AllowAllExcept": Permite la recogida de todos los objetos excepto los listados en
ItemBlacklist[cite: 86].
ItemWhitelist lista
Lista de clases de objetos que pueden recogerse en modo "BlockAllExcept"[cite: 87].
ItemBlacklist lista
Lista de clases de objetos que no pueden recogerse en modo "AllowAllExcept"[cite: 88].
PreventFertilizedEggPickup (objeto)
Configuraciones para evitar la recogida de huevos fertilizados[cite: 89].
Enable booleano
"true" habilita la prohibición de recogida de huevos fertilizados[cite: 89].
AllowAllies booleano
"true" permite a miembros de la alianza recoger huevos[cite: 90].
StructureInteraction (objeto)
Configuraciones para interactuar con estructuras[cite: 91].
DisableTurnOnOff booleano
"true" impide que los jugadores enciendan o apaguen estructuras de otras tribus[cite: 91].
AllowAllies booleano
"true" permite esto para miembros de tribus y alianzas[cite: 92].
AllowUnlockedStructures booleano
"true" permite interactuar con estructuras desbloqueadas[cite: 92].
InventoryView (objeto)
Configuraciones para ver inventarios de otros jugadores[cite: 93].
DisableOtherInventoriesView booleano
"true" impide ver inventarios de estructuras, jugadores, cadáveres, bolsas, etc. de otras tribus[cite: 93].
IgnoreStructuresWithPIN booleano
"true" permite ver inventarios en estructuras con código PIN[cite: 93].
IgnoreUnlockedStructures booleano
"true" permite ver inventarios en estructuras desbloqueadas[cite: 94].
AllowAllies booleano
"true" permite a miembros de alianzas ver inventarios[cite: 94].
Manejo de Dinosaurios
Configuración para proteger dinosaurios domesticados y salvajes de daños e interacciones no deseadas[cite: 95, 97, 99].
BlockAlgaeCollectingFromOthersArchelon booleano
Si es "true", impide que jugadores de otras tribus recojan Algas de tu Archelon[cite: 95].
AllowAlliesAlgaeCollecting booleano
Si es "true", permite a miembros de tribus aliadas recoger Algas de tu Archelon, incluso si el bloqueo principal está habilitado[cite: 96].
DestroyDecayedDinos booleano
"true" habilita la destrucción automática de dinosaurios que alcanzan el tiempo de descomposición[cite: 97]. **IMPORTANTE:** Esta función solo funciona si la descomposición de dinos está activada en el servidor[cite: 98].
DisableDinoMating booleano
"true" impide el apareamiento de dinosaurios entre diferentes tribus[cite: 99].
AllowAlliesDinoMating booleano
"true" permite el apareamiento de dinosaurios entre tribus aliadas[cite: 99].
Manejo de Huevos
Reglas específicas para proteger huevos del robo o destrucción, una forma común de grifeo PvE[cite: 100].
AutoDestroyFertilizedEggs booleano
"true" destruye automáticamente los huevos fertilizados que han sido dejados en el mapa. Esto ayuda a mantener el mapa limpio[cite: 100].
AutoDestroyEggsDelayInSeconds número
Retardo en segundos antes de que un huevo sea destruido[cite: 101].
EggsTypeToDestroy lista
Lista de rutas Blueprint de huevos fertilizados (ej. "Wyvern") que serán destruidos automáticamente[cite: 102].
StructuresPreventingDestruction lista
Lista de rutas Blueprint de estructuras. Un huevo no será destruido si está dentro de un radio de aproximadamente 7 fundaciones de cualquiera de estas estructuras[cite: 103].
Configuraciones Especiales de Estructuras
En esta sección puedes establecer reglas especiales para estructuras específicas usando sus rutas Blueprint[cite: 104]. Puedes agregar un número ilimitado de estructuras[cite: 104].
Ejemplo de Estructura: Oil Pump
Blueprint'/Game/ScorchedEarth/Structures/OilPump/OilPump.OilPump' objeto
Configuraciones para una Oil Pump (ejemplo)[cite: 105].
UnlockOnPlacement booleano
"true" desbloquea automáticamente la estructura justo después de colocarla[cite: 106].
SupportLocking booleano
"false" impide que la estructura sea bloqueada (incluyendo códigos PIN)[cite: 107].
CheckUnlockStateAfterRestart booleano
"true" verifica el estado de bloqueo después de un reinicio del servidor y desbloquea automáticamente la estructura si estaba bloqueada[cite: 107].
Ejemplo de Estructura: Tree Sap Tap
Blueprint'/Game/PrimalEarth/Structures/BuildingBases/TreeSapTap_SM.TreeSapTap_SM' objeto
Configuraciones para un Tree Sap Tap (ejemplo).
UnlockOnPlacement: true, SupportLocking: false, CheckUnlockStateAfterRestart: true
Soporte y Donación
Apoya el Proyecto
Si te gusta este plugin y deseas mostrar tu agradecimiento o apoyar mi trabajo, puedes hacerlo a través de los siguientes enlaces.
Si encontraste un error o necesitas ayuda, únete a mi servidor de Discord.
Обзор
Anti PvE Griefing — максимальная защита для вашего PvE‑сервера ✨
Ваши игроки устали от испорченного имущества, украденных яиц и сломанного игрового процесса из‑за других на сервере? Плагин Anti PvE Griefing — идеальное решение. Он защищает игроков от самых распространённых форм гриферства на PvE‑серверах. 🛡️
Ключевые особенности
- Защита инвентаря 🔒
Запрещает чужим трайбам просматривать инвентари трупов и мешков. Полностью исключает кражу предметов после смерти игрока.
- Контроль структур ⚙️
Гарантирует, что включать/выключать важные структуры (генераторы, фабрикаторы и др.) может только их владелец.
- Контроль спаривания динозавров 🚫
Блокирует спаривание между разными трайбами, предотвращая нежеленное разведение и конфликты.
- Взаимодействие с игроками 🤝
Отключает возможность других игроков тащить и поднимать чужих игроков или динозавров.
- Подбор предметов и яиц 🥚
Запрещает игрокам подбирать выброшенные предметы и оплодотворённые яйца других трайбов.
- "Сгнившие" динозавры 💀
Автоматически уничтожает динозавров, таймер "гниения" которых подошел к концу, вместо того, чтобы отклеймлять их, предотвращая кражу другими трайбами.
- Настройки структур 🔑
Точный контроль для открытых и защищённых PIN‑кодом структур.
- Автоматическое открытие 🔓
Автоматически открывает заданные структуры, чтобы игроки их не запирали.
- Защита оффлайн‑игроков 😴
Настраиваемый таймер защищает игроков, пока они оффлайн.
- Авто‑уничтожение яиц 💥
Позволяет автоматически уничтожать оплодотворённые яйца по белому/чёрному списку.
- Режимы подбора предметов 📦
Гибкие режимы правил подбора: BlockAll, BlockAllExcept или AllowAllExcept.
- Защита водорослей 🌿
Не позволяет другим собирать водоросли с вашего Архелона.
Установка и Требования
Системные Требования
Для работы AntiPVEGriefing потребуется:
- Игра: Сервер ARK: Survival Ascended (ASA)
- API: AsaApi v1.19 или новее
- Зависимости: Пакеты Visual C++ Redistributable 2015–2022
Шаги Установки
- Установка: Скопируйте папку плагина в директорию сервера:
../ShooterGame/Binaries/Win64/ArkApi/Plugins/
- Файлы конфигурации:
config.json: Основной конфигурационный файл.config_help.json: Примеры настроек и пояснения.
- Редактирование: Отредактируйте
config.json любым редактором.
- Применение настроек:
- После первой правки перезапустите сервер.
- Дальше используйте
APG.Reload (RCON) или APGReloadConfig (консоль в игре) без перезапуска.
Список изменений
✨ Обновление 3.1
- Исправлено название параметра в config.json - CheckUnlockStateAfterRestart. Вам нужно открыть config.json и изменить старое название CheckUnlockStateAfterReatart на новое CheckUnlockStateAfterRestart.
- Удалены APG_Documentation.txt и APG_Commands.txt. Вся документация теперь в новом html файле - APG_Documentation.html
✨ Обновление 3.0
- Переработан config.json - теперь более логичный и структурированный.
- Новая папка Docs - включает полную документацию. Внутри вы найдете подробное руководство (APG_Documentation.txt) и полный список команд (APG_Commands.txt).
- Много исправлений для защиты оффлайн - лучшая логика для защиты игроков, которые выходят.
- Доступ к инвентарям специальных структур - инвентари структур в разделе SpecialStructureSettings всегда будут доступны, если структура разблокирована, независимо от других настроек.
- Исправлено спаривание при высоких скоростях спаривания - атакующие больше не могут получать яйца при высоких скоростях спаривания (тестировано с x50, x100); спаривание теперь надежно блокируется.
- Переработана защита подбора предметов - теперь поддерживает новые гибкие режимы: BlockAll, BlockAllExcept, AllowAllExcept (больше информации в config_help.json или файле doc).
- Новый параметр: BlockAlgaeCollectingFromOthersArchelon - предотвращает сбор водорослей с чужих Archelons.
- Обновлен канал docs в discord: 📝documentation
Команды Администратора
Ниже представлен полный список всех доступных команд и их описаний. Эти команды могут использоваться только администраторами сервера (через RCON или внутриигровую консоль с префиксом `cheat`)[cite: 110, 111].
Консольные Команды (В Игре)
- **APGReloadConfig**
Описание: Перезагружает конфигурационный файл плагина без необходимости перезапуска сервера[cite: 112].
Использование: cheat APGReloadConfig [cite: 113]
- **GetTargetBP**
Описание: Выводит путь Blueprint структуры или динозавра, на которого вы смотрите[cite: 113].
Использование: cheat GetTargetBP [cite: 115]
- **GetItemsBP**
Описание: Выводит пути Blueprint всех предметов в вашем инвентаре[cite: 115].
Использование: cheat GetItemsBP [cite: 117]
- **KillTarget**
Описание: Убивает игрока, на которого вы смотрите[cite: 117].
Использование: cheat KillTarget [cite: 118]
RCON Команды (Внешний Инструмент)
Основные Настройки
Все параметры плагина настраиваются в файле config.json. Общие настройки, контролирующие базовое поведение плагина[cite: 70, 71].
OverrideConfigPath строка
Этот параметр позволяет указать собственный путь к файлу конфигурации[cite: 72]. Если это поле заполнено, плагин будет игнорировать настройки в config.json и загружать их из указанного файла[cite: 73]. Для использования стандартного файла оставьте это поле пустым ("")[cite: 74].
AdminsIgnoreProtection булево
Если установлено значение "true", администраторы сервера смогут игнорировать правила защиты, установленные плагином[cite: 75].
Защита Игроков
Настройки, связанные с защитой игроков от непреднамеренного урона и целенаправленных действий других игроков[cite: 76, 78, 81].
OfflineProtection (объект)
Настройки для защиты игроков, которые вышли из игры[cite: 76].
Enable булево
"true" включает иммунитет к урону для вышедших игроков[cite: 76].
DeactivateAfterLoginInSeconds число
Указывает, через сколько секунд после входа игрока в игру их защита от урона будет отключена[cite: 77].
GrabOtherPlayers (объект)
Настройки для предотвращения захвата игроков другими игроками[cite: 78].
Disable булево
"true" запрещает игрокам захватывать персонажей из других трайбов[cite: 79].
AllowAllies булево
"true" разрешает захват персонажей только для членов союзных трайбов (альянсов)[cite: 80].
DinoCarry (объект)
Настройки для предотвращения захвата игроков динозаврами с наездниками[cite: 81].
Disable булево
"true" запрещает оседланному динозавру захватывать игроков из других трайбов[cite: 82].
AllowAllies булево
"true" разрешает это только для членов союзных трайбов (альянсов)[cite: 83].
Защита Структур и Предметов
Настройки для защиты структур и предотвращения взаимодействия с предметами или причинения урона членами не своего трайба[cite: 84, 89, 91, 93].
PreventItemPickup (объект)
Настройки для предотвращения подбора предметов[cite: 84].
Enable булево
"true" включает функцию предотвращения подбора предметов[cite: 84].
AllowAllies булево
"true" разрешает членам трайба и альянса подбирать предметы[cite: 84].
Mode строка
Определяет режим работы функции[cite: 85]. Возможные значения:
- "BlockAll": Блокирует подбор всех предметов[cite: 85].
- "BlockAllExcept": Блокирует все предметы, кроме перечисленных в
ItemWhitelist[cite: 86].
- "AllowAllExcept": Разрешает подбор всех предметов, кроме перечисленных в
ItemBlacklist[cite: 86].
ItemWhitelist массив
Список классов предметов, которые можно подбирать в режиме "BlockAllExcept"[cite: 87].
ItemBlacklist массив
Список классов предметов, которые нельзя подбирать в режиме "AllowAllExcept"[cite: 88].
PreventFertilizedEggPickup (объект)
Настройки для предотвращения подбора оплодотворенных яиц[cite: 89].
Enable булево
"true" включает запрет на подбор оплодотворенных яиц[cite: 89].
AllowAllies булево
"true" разрешает членам альянса подбирать яйца[cite: 90].
StructureInteraction (объект)
Настройки для взаимодействия со структурами[cite: 91].
DisableTurnOnOff булево
"true" запрещает игрокам включать/выключать структуры других трайбов[cite: 91].
AllowAllies булево
"true" разрешает это для членов альянсов[cite: 92].
AllowUnlockedStructures булево
"true" разрешает взаимодействие с открытыми структурами[cite: 92].
InventoryView (объект)
Настройки для просмотра инвентарей других игроков[cite: 93].
DisableOtherInventoriesView булево
"true" запрещает просмотр инвентарей структур, игроков, трупов, мешков и т. д. других трайбов[cite: 93].
IgnoreStructuresWithPIN булево
"true" разрешает просмотр инвентарей в структурах с установленным PIN-кодом[cite: 93].
IgnoreUnlockedStructures булево
"true" разрешает просмотр инвентарей в открытых структурах[cite: 94].
AllowAllies булево
"true" разрешает членам альянса просматривать инвентари[cite: 94].
Управление Динозаврами
Конфигурация для защиты прирученных динозавров от нежелательных взаимодействий[cite: 95, 97, 99].
BlockAlgaeCollectingFromOthersArchelon булево
Если "true", запрещает игрокам из других трайбов собирать водоросли с вашего Архелона[cite: 95].
AllowAlliesAlgaeCollecting булево
Если "true", разрешает членам союзных трайбов (альянсов) собирать водоросли с вашего Архелона, даже если основная блокировка включена[cite: 96].
DestroyDecayedDinos булево
"true" включает автоматическое уничтожение динозавров, у которых истек таймер разложения[cite: 97]. **ВАЖНО:** Эта функция работает только при включенном разложении динозавров на сервере[cite: 98].
DisableDinoMating булево
"true" предотвращает спаривание динозавров между разными трайбами[cite: 99].
AllowAlliesDinoMating булево
"true" разрешает спаривание динозавров между альянсами[cite: 99].
Управление Яйцами
Специальные правила для защиты яиц от кражи, что является распространенной формой PvE-гриферства[cite: 100].
AutoDestroyFertilizedEggs булево
"true" автоматически уничтожает оплодотворенные яйца, которые были брошены на карте. Это помогает поддерживать чистоту карты[cite: 100].
AutoDestroyEggsDelayInSeconds число
Задержка в секундах перед уничтожением яйца[cite: 101].
EggsTypeToDestroy массив
Список оплодотворенных яиц (например, "Wyvern"), которые будут автоматически уничтожены[cite: 102].
StructuresPreventingDestruction массив
Список путей Blueprint структур. Яйцо не будет уничтожено, если оно находится в радиусе примерно 7 фундаментов от любой из этих структур[cite: 103].
Настройки Специальных Структур
В этом разделе вы можете настроить специальные правила для любых конкретных структур, используя их пути Blueprint[cite: 104]. Вы можете добавить неограниченное количество структур[cite: 104].
Пример Структуры: Oil Pump (Нефтяной Насос)
Blueprint'/Game/ScorchedEarth/Structures/OilPump/OilPump.OilPump' объект
Настройки для Oil Pump (используется в качестве примера)[cite: 105].
UnlockOnPlacement булево
"true" автоматически открывает структуру сразу после ее размещения[cite: 106].
SupportLocking булево
"false" запрещает запирание структуры (включая PIN-коды)[cite: 107].
CheckUnlockStateAfterRestart булево
"true" проверяет состояние запертости после перезапуска сервера и автоматически открывает структуру, если она была закрыта[cite: 107].
Пример Структуры: Tree Sap Tap (Сборщик Древесного Сока)
Blueprint'/Game/PrimalEarth/Structures/BuildingBases/TreeSapTap_SM.TreeSapTap_SM' объект
Настройки для Tree Sap Tap (используется в качестве примера).
UnlockOnPlacement: true, SupportLocking: false, CheckUnlockStateAfterReatart: true
Поддержка и Донат
Поддержите проект
Если вам нравится этот плагин и вы хотите выразить признательность или поддержать мою работу — воспользуйтесь ссылками ниже.
Если вы нашли баг или нужна помощь, присоединяйтесь к моему Discord серверу.
概览
Anti PvE Griefing – 保护你的 PvE 服务器的终极方案 ✨
你的玩家是否厌倦了财产被破坏、鸡蛋被偷，或是游戏体验被他人毁掉？Anti PvE Griefing 插件是完美的解决方案。它能保护你的玩家免受 PvE 服务器上最常见的恶意破坏行为。🛡️
关键特性
- 物品栏保护 🔒
阻止其他部落查看尸体与背包的物品栏，彻底杜绝死亡后的物品盗窃。
- 结构控制 ⚙️
确保只有所有者才能开启/关闭关键结构，如发电机、制造台等。
- 恐龙交配控制 🚫
阻止不同部落之间的恐龙交配，避免不必要的繁殖与冲突。
- 玩家互动 🤝
禁用其他玩家拖拽/搬运你的玩家或恐龙的能力。
- 物品与受精蛋拾取 🥚
防止未授权玩家拾取其他部落掉落的物品和受精蛋。
- 腐烂恐龙 💀
自动销毁腐烂计时结束的恐龙，避免被他人占领地盘。
- 结构设置 🔑
对未上锁或使用 PIN 的结构进行细粒度控制。
- 自动解锁 🔓
自动解锁特定结构，防止被误锁。
- 离线玩家保护 😴
可配置的计时器在玩家离线时保护其人身与财产。
- 自动销毁受精蛋 💥
支持通过白名单/黑名单自动销毁受精蛋，以帮助控制恐龙数量。
- 物品拾取模式 📦
灵活模式：BlockAll、BlockAllExcept 或 AllowAllExcept。
- 海藻保护 🌿
阻止其他玩家从你的 Archelon 海藻采集器处采集海藻。
安装与要求
系统要求
运行 AntiPVEGriefing 需要：
- 游戏： ARK: Survival Ascended 服务器 (ASA)
- API： AsaApi v1.19 或更高版本
- 依赖： Visual C++ Redistributable 2015–2022 包
安装步骤
- 安装： 将插件文件夹复制到服务器目录：
../ShooterGame/Binaries/Win64/ArkApi/Plugins/
- 配置文件：
config.json：主配置文件。config_help.json：示例与注释说明。
- 编辑： 使用任意文本编辑器修改
config.json。
- 应用设置：
- 首次编辑后重启服务器。
- 后续修改使用
APG.Reload（RCON）或 APGReloadConfig（游戏内控制台）生效。
补丁说明
✨ 更新 3.1
- config.json 中的参数名称已修复 - CheckUnlockStateAfterRestart。您需要打开 config.json 并将旧名称 CheckUnlockStateAfterReatart 更改为新名称 CheckUnlockStateAfterRestart。
- 删除了 APG_Documentation.txt 和 APG_Commands.txt。所有文档现在在新 html 文件中 - APG_Documentation.html
✨ 更新 3.0
- 重构了 config.json - 现在更逻辑和结构化。
- 新 Docs 文件夹 - 包括完整文档。在里面您会找到详细指南 (APG_Documentation.txt) 和完整命令列表 (APG_Commands.txt)。
- 离线保护的许多修复 - 更好的逻辑来保护登出的玩家。
- 特殊结构库存访问 - SpecialStructureSettings 部分中的结构库存如果结构解锁，将始终可访问，无论其他设置如何。
- 修复了高交配率下的交配 - 攻击者无法再在高交配率下获得蛋 (测试了 x50, x100); 交配现在可靠地被阻止。
- 重构了物品拾取保护 - 现在支持新的灵活模式: BlockAll, BlockAllExcept, AllowAllExcept (更多信息在 config_help.json 或 doc 文件中)。
- 新参数: BlockAlgaeCollectingFromOthersArchelon - 防止玩家从其他人的 Archelon 收获海藻。
- 更新了 discord docs 频道: 📝documentation
管理员指令
以下是所有可用命令及其描述的完整列表。这些命令只能由服务器管理员使用（通过 RCON 或使用 `cheat` 前缀的游戏内控制台） [cite: 110, 111]。
控制台指令 (游戏内)
- **APGReloadConfig**
描述: 无需重启服务器即可重新加载插件的配置文件 [cite: 112]。
用法: cheat APGReloadConfig [cite: 113]
- **GetTargetBP**
描述: 打印目标建筑或恐龙的蓝图路径 [cite: 113]。
用法: cheat GetTargetBP [cite: 115]
- **GetItemsBP**
描述: 打印管理员背包中所有物品的蓝图路径 [cite: 115]。
用法: cheat GetItemsBP [cite: 117]
- **KillTarget**
描述: 击杀目标玩家 [cite: 117]。
用法: cheat KillTarget [cite: 118]
RCON 指令 (外部工具)
通用配置
所有插件参数都在 config.json 文件中配置。通用设置控制插件的基本行为 [cite: 70, 71]。
OverrideConfigPath 字符串
此参数允许您指定配置文件的自定义路径 [cite: 72]。如果填写此字段，插件将忽略 config.json 中的设置，并从指定的路径加载 [cite: 73]。要使用标准文件，请将此字段留空 ("") [cite: 74]。
AdminsIgnoreProtection 布尔值
如果设置为 "true"，服务器管理员将能够忽略插件设置的所有保护规则 [cite: 75]。
玩家保护
与保护玩家免受友军伤害、意外伤害和被其他玩家针对性行动相关的设置 [cite: 76, 78, 81]。
OfflineProtection (对象)
用于保护已下线玩家的设置 [cite: 76]。
Enable 布尔值
"true" 启用对离线玩家的伤害免疫 [cite: 76]。
DeactivateAfterLoginInSeconds 数字
指定玩家登录后，其伤害保护将被禁用的秒数 [cite: 77]。
GrabOtherPlayers (对象)
防止玩家抓取其他玩家的设置 [cite: 78]。
Disable 布尔值
"true" 阻止玩家抓取其他部落的角色 [cite: 79]。
AllowAllies 布尔值
"true" 允许仅针对盟友部落（联盟）成员抓取角色 [cite: 80]。
DinoCarry (对象)
防止有骑手的恐龙抓取其他玩家的设置 [cite: 81]。
Disable 布尔值
"true" 阻止被骑乘的恐龙抓取其他部落的玩家 [cite: 82]。
AllowAllies 布尔值
"true" 允许仅针对盟友部落（联盟）成员进行此操作 [cite: 83]。
建筑与物品保护
用于保护建筑和防止非部落成员与物品互动或造成伤害的设置 [cite: 84, 89, 91, 93]。
PreventItemPickup (对象)
阻止物品拾取的设置 [cite: 84]。
Enable 布尔值
"true" 启用物品拾取阻止功能 [cite: 84]。
AllowAllies 布尔值
"true" 允许部落成员和联盟成员拾取物品 [cite: 84]。
Mode 字符串
定义该功能的操作模式 [cite: 85]。可能的值:
- "BlockAll": 阻止拾取所有物品 [cite: 85]。
- "BlockAllExcept": 阻止除
ItemWhitelist 中列出的物品以外的所有物品 [cite: 86]。
- "AllowAllExcept": 允许拾取除
ItemBlacklist 中列出的物品以外的所有物品 [cite: 86]。
ItemWhitelist 数组
在 "BlockAllExcept" 模式下可以拾取的物品类别列表 [cite: 87]。
ItemBlacklist 数组
在 "AllowAllExcept" 模式下不能拾取的物品类别列表 [cite: 88]。
PreventFertilizedEggPickup (对象)
阻止拾取受精卵的设置 [cite: 89]。
Enable 布尔值
"true" 启用禁止拾取受精卵 [cite: 89]。
AllowAllies 布尔值
"true" 允许联盟成员拾取蛋 [cite: 90]。
StructureInteraction (对象)
与建筑互动的设置 [cite: 91]。
DisableTurnOnOff 布尔值
"true" 阻止玩家开关其他部落的建筑 [cite: 91]。
AllowAllies 布尔值
"true" 允许部落成员和联盟成员执行此操作 [cite: 92]。
AllowUnlockedStructures 布尔值
"true" 允许与未锁定的建筑进行互动 [cite: 92]。
InventoryView (对象)
查看其他玩家物品栏的设置 [cite: 93]。
DisableOtherInventoriesView 布尔值
"true" 阻止查看其他部落的建筑、玩家、尸体、背包等的物品栏 [cite: 93]。
IgnoreStructuresWithPIN 布尔值
"true" 允许查看设置了 PIN 码的建筑的物品栏 [cite: 93]。
IgnoreUnlockedStructures 布尔值
"true" 允许查看未锁定建筑的物品栏 [cite: 94]。
AllowAllies 布尔值
"true" 允许联盟成员查看物品栏 [cite: 94]。
恐龙管理
用于保护驯服和野生恐龙免受伤害和不必要互动的配置 [cite: 95, 97, 99]。
BlockAlgaeCollectingFromOthersArchelon 布尔值
如果为 "true"，则阻止其他部落的玩家从您的 Archelon 身上收集藻类 [cite: 95]。
AllowAlliesAlgaeCollecting 布尔值
如果为 "true"，则允许盟友部落（联盟）的成员从您的 Archelon 身上收集藻类，即使主要阻止功能已启用 [cite: 96]。
DestroyDecayedDinos 布尔值
"true" 启用自动销毁达到腐烂计时器的恐龙 [cite: 97]。**重要提示:** 此功能仅在服务器上启用恐龙腐烂时才有效 [cite: 98]。
DisableDinoMating 布尔值
"true" 阻止不同部落之间的恐龙交配 [cite: 99]。
AllowAlliesDinoMating 布尔值
"true" 允许盟友部落之间的恐龙交配 [cite: 99]。
蛋管理
保护蛋免受偷窃或破坏的特定规则，这是 PvE 恶意破坏的常见形式 [cite: 100]。
AutoDestroyFertilizedEggs 布尔值
"true" 自动销毁被丢弃在地图上的受精卵。这有助于保持地图清洁 [cite: 100]。
AutoDestroyEggsDelayInSeconds 数字
蛋被销毁前的延迟时间（秒） [cite: 101]。
EggsTypeToDestroy 数组
将被自动销毁的受精蛋蓝图路径列表（例如，"Wyvern"） [cite: 102]。
StructuresPreventingDestruction 数组
建筑蓝图路径列表。如果蛋位于任何这些建筑约 7 个地基的半径范围内，则不会被销毁 [cite: 103]。
特殊建筑设置
在此部分中，您可以使用建筑的蓝图路径为任何特定建筑设置特殊规则 [cite: 104]。您可以添加无限数量的建筑 [cite: 104]。
建筑示例: Oil Pump (油泵)
Blueprint'/Game/ScorchedEarth/Structures/OilPump/OilPump.OilPump' 对象
Oil Pump 的设置（用作示例） [cite: 105]。
UnlockOnPlacement 布尔值
"true" 在放置后立即自动解锁建筑 [cite: 106]。
SupportLocking 布尔值
"false" 阻止建筑被锁定（包括 PIN 码） [cite: 107]。
CheckUnlockStateAfterRestart 布尔值
"true" 在服务器重启后检查锁定状态，如果建筑已锁定，则自动解锁 [cite: 107]。
建筑示例: Tree Sap Tap (树液水龙头)
Blueprint'/Game/PrimalEarth/Structures/BuildingBases/TreeSapTap_SM.TreeSapTap_SM' 对象
Tree Sap Tap 的设置（用作示例）。
UnlockOnPlacement: true, SupportLocking: false, CheckUnlockStateAfterReatart: true
支持与捐赠
支持本项目
如果您喜欢这个插件并想表达感谢或支持我的工作，可以通过下面的链接进行支持。
如果您发现了错误或需要帮助，请加入我的 Discord 服务器。
Überblick
Anti PvE Griefing – Der ultimative Schutz für deinen PvE‑Server ✨
Sind deine Spieler es leid, dass ihr Eigentum beschädigt, ihre Eier gestohlen oder ihr Spielerlebnis von anderen ruiniert wird? Das Anti PvE Griefing Plugin ist die perfekte Lösung. Es schützt deine Spieler vor den häufigsten Formen des Griefings auf PvE‑Servern. 🛡️
Schlüssel‑Features
- Inventarschutz 🔒
Verhindert, dass andere Stämme die Inventare von Leichen und Taschen einsehen. Beseitigt vollständig Item‑Diebstahl nach dem Tod.
- Strukturkontrolle ⚙️
Stellt sicher, dass nur der Besitzer wichtige Strukturen wie Generatoren, Fabrikatoren u. a. ein-/ausschalten kann.
- Dino‑Paarungskontrolle 🚫
Stoppt die Paarung zwischen verschiedenen Stämmen und verhindert unerwünschte Zucht und Konflikte.
- Spielerinteraktion 🤝
Deaktiviert das Ziehen/Tragen deiner Spieler oder Dinos durch andere.
- Gegenstands- & Eieraufnahme 🥚
Verhindert, dass Unbefugte fallengelassene Items und befruchtete Eier anderer Stämme aufsammeln.
- Verfallene Dinos 💀
Zerstört verfallene Dinos automatisch statt sie als unclaimed zu lassen, um Gebietsübernahme zu verhindern.
- Struktureinstellungen 🔑
Feinsteuerung für ungesperrte oder per PIN gesicherte Strukturen.
- Automatisches Entsperren 🔓
Entsperrt bestimmte Strukturen automatisch, um versehentliches Sperren zu verhindern.
- Offline‑Spielerschutz 😴
Ein anpassbarer Timer schützt Spieler und Eigentum, während sie offline sind.
- Automatisches Zerstören von Eiern 💥
Erlaubt das automatische Zerstören befruchteter Eier via Whitelist/Blacklist zur Populationskontrolle.
- Item‑Aufnahmemodi 📦
Flexible Modi: BlockAll, BlockAllExcept oder AllowAllExcept.
- Algen‑Schutz 🌿
Verhindert, dass andere Algen von deinem Archelon‑Sammler ernten.
Installation & Anforderungen
Systemanforderungen
Um AntiPVEGriefing auszuführen, benötigst du:
- Spiel: ARK: Survival Ascended Server (ASA)
- API: AsaApi v1.19 oder neuer
- Abhängigkeiten: Visual C++ Redistributable-Pakete 2015–2022
Installationsschritte
- Installation: Kopiere den Plugin‑Ordner in dein Serververzeichnis:
../ShooterGame/Binaries/Win64/ArkApi/Plugins/
- Konfigurationsdateien:
config.json: Hauptkonfigurationsdatei.config_help.json: Beispiele und Erläuterungen.
- Bearbeitung: Bearbeite
config.json mit einem Editor deiner Wahl.
- Einstellungen anwenden:
- Nach der ersten Bearbeitung den Server neu starten.
- Weitere Änderungen mit
APG.Reload (RCON) oder APGReloadConfig (In‑Game Konsole) übernehmen.
Patch-Notizen
✨ Update 3.1
- Der Parametername in config.json wurde korrigiert - CheckUnlockStateAfterRestart. Sie müssen config.json öffnen und den alten Namen CheckUnlockStateAfterReatart in den neuen CheckUnlockStateAfterRestart ändern.
- APG_Documentation.txt und APG_Commands.txt entfernt. Alle Docs jetzt in neuer html-Datei - APG_Documentation.html
✨ Update 3.0
- config.json überarbeitet - jetzt logischer und strukturierter.
- Neuer Docs-Ordner - enthält vollständige Dokumentation. Darin finden Sie eine detaillierte Anleitung (APG_Documentation.txt) und eine vollständige Befehlsliste (APG_Commands.txt).
- Viele Fixes für Offline-Schutz - bessere Logik zum Schutz von Spielern, die sich abmelden.
- Spezielle Struktur-Inventarzugriff - Inventare von Strukturen im Abschnitt SpecialStructureSettings sind immer zugänglich, wenn die Struktur entsperrt ist, unabhängig von anderen Einstellungen.
- Paarung bei hohen Paarungsraten behoben - Angreifer können keine Eier mehr bei hohen Paarungsraten erhalten (getestet mit x50, x100); Paarung wird jetzt zuverlässig blockiert.
- Item-Aufnahme-Schutz überarbeitet - unterstützt jetzt neue flexible Modi: BlockAll, BlockAllExcept, AllowAllExcept (mehr Info in config_help.json oder Doc-Datei).
- Neuer Parameter: BlockAlgaeCollectingFromOthersArchelon - verhindert, dass Spieler Algen von anderen Archelons ernten.
- Discord-Docs-Kanal aktualisiert: 📝documentation
Admin-Befehle
Eine vollständige Liste aller verfügbaren Befehle und ihrer Beschreibungen finden Sie unten. Diese Befehle können nur von Serveradministratoren verwendet werden (über RCON oder die In-Game-Konsole mit dem Präfix `cheat`)[cite: 110, 111].
Konsolenbefehle (In-Game)
- **APGReloadConfig**
Beschreibung: Lädt die Konfigurationsdatei des Plugins neu, ohne dass ein Serverneustart erforderlich ist[cite: 112].
Verwendung: cheat APGReloadConfig [cite: 113]
- **GetTargetBP**
Beschreibung: Gibt den Blueprint-Pfad der anvisierten Struktur oder des Dinosauriers aus[cite: 113].
Verwendung: cheat GetTargetBP [cite: 115]
- **GetItemsBP**
Beschreibung: Gibt die Blueprint-Pfade aller Gegenstände im Inventar des Administrators aus[cite: 115].
Verwendung: cheat GetItemsBP [cite: 117]
- **KillTarget**
Beschreibung: Tötet den anvisierten Spieler[cite: 117].
Verwendung: cheat KillTarget [cite: 118]
RCON-Befehle (Externes Tool)
Allgemeine Einstellungen
Alle Plugin-Parameter werden in der Datei config.json konfiguriert. Allgemeine Einstellungen, die das grundlegende Verhalten des Plugins steuern[cite: 70, 71].
OverrideConfigPath string
Dieser Parameter ermöglicht es Ihnen, einen benutzerdefinierten Pfad zur Konfigurationsdatei anzugeben[cite: 72]. Wenn dieses Feld ausgefüllt ist, ignoriert das Plugin die Einstellungen in config.json und lädt sie aus dem angegebenen Pfad[cite: 73]. Um die Standarddatei zu verwenden, lassen Sie dieses Feld leer ("")[cite: 74].
AdminsIgnoreProtection boolean
Wenn "true", können Serveradministratoren alle Schutzregeln des Plugins ignorieren[cite: 75].
Spielerschutz
Einstellungen zum Schutz von Spielern vor Friendly Fire, unbeabsichtigtem Schaden und gezielten Aktionen anderer Spieler[cite: 76, 78, 81].
OfflineProtection (object)
Einstellungen zum Schutz von Spielern, die sich abgemeldet haben[cite: 76].
Enable boolean
"true" aktiviert Immunität gegen Schaden für offline Spieler[cite: 76].
DeactivateAfterLoginInSeconds number
Gibt an, nach wie vielen Sekunden nach dem Login eines Spielers der Schadenschutz deaktiviert wird[cite: 77].
GrabOtherPlayers (object)
Einstellungen, um zu verhindern, dass Spieler andere Spieler greifen[cite: 78].
Disable boolean
"true" verhindert, dass Spieler Charaktere von anderen Stämmen greifen[cite: 79].
AllowAllies boolean
"true" erlaubt das Greifen von Charakteren nur für Mitglieder verbündeter Stämme (Allianzen)[cite: 80].
DinoCarry (object)
Einstellungen, um zu verhindern, dass Dinosaurier mit Reitern andere Spieler greifen[cite: 81].
Disable boolean
"true" verhindert, dass ein gerittener Dino Spieler von anderen Stämmen greift[cite: 82].
AllowAllies boolean
"true" erlaubt dies nur für Mitglieder verbündeter Stämme (Allianzen)[cite: 83].
Struktur- und Gegenstandsschutz
Einstellungen zum Schutz von Strukturen und zur Verhinderung der Interaktion von Nicht-Stammesmitgliedern mit Gegenständen oder der Verursachung von Schaden[cite: 84, 89, 91, 93].
PreventItemPickup (object)
Einstellungen, um das Aufheben von Gegenständen zu verhindern[cite: 84].
Enable boolean
"true" aktiviert die Funktion zur Verhinderung des Aufhebens von Gegenständen[cite: 84].
AllowAllies boolean
"true" erlaubt Allianzmitgliedern, Gegenstände aufzuheben[cite: 84].
Mode string
Definiert den Betriebsmodus der Funktion[cite: 85]. Mögliche Werte:
- "BlockAll": Blockiert das Aufheben aller Gegenstände[cite: 85].
- "BlockAllExcept": Blockiert alle Gegenstände außer denen, die in
ItemWhitelist aufgelistet sind[cite: 86].
- "AllowAllExcept": Erlaubt das Aufheben aller Gegenstände außer denen, die in
ItemBlacklist aufgelistet sind[cite: 86].
ItemWhitelist array
Eine Liste von Gegenstandsklassen, die im "BlockAllExcept"-Modus aufgehoben werden können[cite: 87].
ItemBlacklist array
Eine Liste von Gegenstandsklassen, die im "AllowAllExcept"-Modus nicht aufgehoben werden können[cite: 88].
PreventFertilizedEggPickup (object)
Einstellungen, um das Aufheben befruchteter Eier zu verhindern[cite: 89].
Enable boolean
"true" aktiviert das Verbot des Aufhebens befruchteter Eier[cite: 89].
AllowAllies boolean
"true" erlaubt Allianzmitgliedern, Eier aufzuheben[cite: 90].
StructureInteraction (object)
Einstellungen für die Interaktion mit Strukturen[cite: 91].
DisableTurnOnOff boolean
"true" verhindert, dass Spieler Strukturen anderer Stämme ein-/ausschalten[cite: 91].
AllowAllies boolean
"true" erlaubt dies für Allianzmitglieder[cite: 92].
AllowUnlockedStructures boolean
"true" erlaubt das Ein-/Ausschalten ungesperrter Strukturen[cite: 92].
InventoryView (object)
Einstellungen für die Ansicht anderer Inventare[cite: 93].
DisableOtherInventoriesView boolean
"true" verhindert die Ansicht der Inventare von Strukturen anderer Stämme, Spielern, Leichen, Taschen usw.[cite: 93].
IgnoreStructuresWithPIN boolean
"true" erlaubt die Ansicht von Inventaren in Strukturen mit gesetztem PIN-Code[cite: 93].
IgnoreUnlockedStructures boolean
"true" erlaubt die Ansicht von Inventaren in ungesperrten Strukturen[cite: 94].
AllowAllies boolean
"true" erlaubt Allianzmitgliedern, Inventare anzusehen[cite: 94].
Dino-Management
Konfiguration zum Schutz gezähmter und wilder Dinosaurier vor Schaden und unerwünschten Interaktionen[cite: 95, 97, 99].
BlockAlgaeCollectingFromOthersArchelon boolean
Wenn "true", verhindert es, dass Spieler von anderen Stämmen Algen von Ihrem Archelon sammeln[cite: 95].
AllowAlliesAlgaeCollecting boolean
Wenn "true", erlaubt es Mitgliedern verbündeter Stämme (Allianzen), Algen von Ihrem Archelon zu sammeln, auch wenn die primäre Blockierung aktiviert ist[cite: 96].
DestroyDecayedDinos boolean
"true" aktiviert die automatische Zerstörung von Dinosauriern, die ihren Verfalls-Timer erreicht haben[cite: 97]. **WICHTIG:** Diese Funktion funktioniert nur, wenn Dino-Verfall auf dem Server aktiviert ist[cite: 98].
DisableDinoMating boolean
"true" verhindert die Paarung von Dinosauriern zwischen verschiedenen Stämmen[cite: 99].
AllowAlliesDinoMating boolean
"true" erlaubt die Paarung von Dinosauriern zwischen verbündeten Stämmen[cite: 99].
Eier-Management
Spezifische Regeln zum Schutz von Eiern vor Diebstahl oder Zerstörung, einer häufigen Form des PvE-Griefings[cite: 100].
AutoDestroyFertilizedEggs boolean
"true" zerstört automatisch befruchtete Eier, die auf der Karte fallen gelassen wurden. Dies hilft dabei, die Karte sauber zu halten[cite: 100].
AutoDestroyEggsDelayInSeconds number
Die Verzögerung in Sekunden, bevor ein Ei zerstört wird[cite: 101].
EggsTypeToDestroy array
Eine Liste von befruchteten Eitypen (z. B. "Wyvern"), die automatisch zerstört werden[cite: 102].
StructuresPreventingDestruction array
Eine Liste von Struktur-Blueprint-Pfaden. Ein Ei wird nicht zerstört, wenn es sich im Umkreis von ungefähr 7 Fundamenten von einer dieser Strukturen befindet[cite: 103].
Spezielle Struktur-Einstellungen
In diesem Abschnitt können Sie spezielle Regeln für beliebige spezifische Strukturen mit ihren Blueprint-Pfaden einrichten[cite: 104]. Sie können eine unbegrenzte Anzahl von Strukturen hinzufügen[cite: 104].
Beispiel Struktur: Öl-Pumpe (Oil Pump)
Blueprint'/Game/ScorchedEarth/Structures/OilPump/OilPump.OilPump' object
Einstellungen für eine Öl-Pumpe (als Beispiel verwendet)[cite: 105].
UnlockOnPlacement boolean
"true" entsperrt die Struktur automatisch sofort nach der Platzierung[cite: 106].
SupportLocking boolean
"false" verhindert, dass die Struktur gesperrt werden kann (einschließlich PIN-Codes)[cite: 107].
CheckUnlockStateAfterRestart boolean
"true" überprüft den Sperrzustand nach einem Server-Neustart und entsperrt die Struktur automatisch, falls sie gesperrt war[cite: 107].
Beispiel Struktur: Baumharz-Zapfhahn (Tree Sap Tap)
Blueprint'/Game/PrimalEarth/Structures/BuildingBases/TreeSapTap_SM.TreeSapTap_SM' object
Einstellungen für einen Baumharz-Zapfhahn (als Beispiel verwendet).
UnlockOnPlacement: true, SupportLocking: false, CheckUnlockStateAfterRestart: true
Support und Spenden
Unterstütze das Projekt
Wenn dir dieses Plugin gefällt und du deine Wertschätzung zeigen oder meine Arbeit unterstützen möchtest, nutze die folgenden Links.
Wenn du einen Fehler gefunden hast oder Hilfe brauchst, tritt meinem Discord-Server bei.