isle-evrima-rcon 1.0.0 → 1.0.2

package/README.md

@@ -209,11 +209,36 @@ When `autoReconnect` is enabled:
 | Method | Description |
 |--------|-------------|
 | `setAI(enabled)` | Toggle AI spawning |
-| `disableAIClasses(classes)` | Disable specific AI types |
+| `disableAIClasses(classes)` | Disable specific AI dinosaur types |
 | `setAIDensity(0.0-1.0)` | Set AI spawn density |
 | `setAILearning(enabled)` | Toggle AI learning behavior |
 | `getQueueStatus()` | Get server queue status |
 
+### Game Constants
+
+The library includes typed constants for dinosaurs and AI creatures:
+
+```typescript
+import { 
+  PLAYABLE_DINOSAURS,    // Playable dino classes
+  AI_CREATURE_CLASSES,   // Ambient AI wildlife
+  type PlayableDinosaur,
+  type AICreatureClass 
+} from 'isle-evrima-rcon';
+
+// Disable ambient AI creatures (wildlife NPCs)
+await client.disableAIClasses(['Compsognathus', 'Deer', 'Boar']);
+
+// AI_CREATURE_CLASSES includes:
+// Compsognathus, Pterodactylus, Boar, Deer, Goat, Seaturtle, Rabbit, Crab
+
+// PLAYABLE_DINOSAURS includes all 20 playable dinos:
+// Dryosaurus, Hypsilophodon, Pachycephalosaurus, Stegosaurus, Tenontosaurus,
+// Diabloceratops, Maiasaura, Triceratops, Carnotaurus, Ceratosaurus,
+// Deinosuchus, Omniraptor, Pteranodon, Troodon, Beipiaosaurus, Gallimimus,
+// Dilophosaurus, Herrerasaurus, Allosaurus, Tyrannosaurus
+```
+
 ### Low-Level Commands
 
 | Method | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "isle-evrima-rcon",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "High-performance, type-safe TypeScript RCON client for The Isle: Evrima game servers with auto-reconnect and connection pooling",
 	"author": "MENIX <https://github.com/menix1337>",
 	"license": "MIT",

package/src/client.ts

@@ -12,6 +12,7 @@ import {
 	type PlayerInfo,
 	type PlayerData,
 	type ServerDetails,
+	type AICreatureClass,
 	RCONError,
 	RCONErrorCode,
 } from './types.js';
@@ -464,10 +465,22 @@ export class EvrimaRCON {
 	}
 
 	/**
-	 * Disable specific AI classes.
-	 * @param classes - Array of AI class names to disable
+	 * Disable specific ambient AI creature classes.
+	 *
+	 * These are NPC wildlife (not playable dinosaurs) like Compsognathus, Deer, Boar, etc.
+	 *
+	 * @param classes - Array of AI creature class names to disable
+	 *
+	 * @example
+	 * ```typescript
+	 * // Type-safe with autocomplete
+	 * await client.disableAIClasses(['Compsognathus', 'Deer', 'Boar']);
+	 *
+	 * // Or use the AI_CREATURE_CLASSES constant
+	 * import { AI_CREATURE_CLASSES } from 'isle-evrima-rcon';
+	 * ```
 	 */
-	async disableAIClasses(classes: string[]): Promise<CommandResult> {
+	async disableAIClasses(classes: (AICreatureClass | string)[]): Promise<CommandResult> {
 		return this.sendCommand('ai:classes:disable', classes.join(','));
 	}
 

package/src/index.ts

@@ -47,9 +47,11 @@ export type {
 	ServerDetails,
 	CommandDefinition,
 	RCONErrorCode,
+	PlayableDinosaur,
+	AICreatureClass,
 } from './types.js';
 
-export { RCONError } from './types.js';
+export { RCONError, PLAYABLE_DINOSAURS, AI_CREATURE_CLASSES } from './types.js';
 
 // Command registry exports
 export {

package/src/types.ts

@@ -257,3 +257,65 @@ export class RCONError extends Error {
 		Object.setPrototypeOf(this, RCONError.prototype);
 	}
 }
+
+// ============================================================================
+// Game Constants
+// ============================================================================
+
+/**
+ * All playable dinosaur/creature classes in The Isle: Evrima.
+ *
+ * Used for commands like `updateplayables` and `getplayables`.
+ * List is current as of January 2026 and may expand with game updates.
+ */
+export const PLAYABLE_DINOSAURS = [
+	// Herbivores
+	'Dryosaurus',
+	'Hypsilophodon',
+	'Pachycephalosaurus',
+	'Stegosaurus',
+	'Tenontosaurus',
+	'Diabloceratops',
+	'Maiasaura',
+	'Triceratops',
+	// Carnivores
+	'Carnotaurus',
+	'Ceratosaurus',
+	'Deinosuchus',
+	'Omniraptor',
+	'Pteranodon',
+	'Troodon',
+	'Beipiaosaurus',
+	'Gallimimus',
+	'Dilophosaurus',
+	'Herrerasaurus',
+	'Allosaurus',
+	'Tyrannosaurus',
+] as const;
+
+/**
+ * Type representing valid playable dinosaur names.
+ */
+export type PlayableDinosaur = (typeof PLAYABLE_DINOSAURS)[number];
+
+/**
+ * Ambient AI creature classes that can be toggled/disabled.
+ *
+ * These are the NPC wildlife that spawn in the world, NOT playable dinosaurs.
+ * Used for the `disableAIClasses` command.
+ */
+export const AI_CREATURE_CLASSES = [
+	'Compsognathus',
+	'Pterodactylus',
+	'Boar',
+	'Deer',
+	'Goat',
+	'Seaturtle',
+	'Rabbit',
+	'Crab',
+] as const;
+
+/**
+ * Type representing valid AI creature class names.
+ */
+export type AICreatureClass = (typeof AI_CREATURE_CLASSES)[number];