@weppy/roblox-mcp 0.1.0

package/plugins/weppy-roblox-mcp/skills/roblox-templates/assets/maps/sources/terrain-presets.json

@@ -0,0 +1,272 @@
+{
+  "_meta": {
+    "category": "terrain-presets",
+    "description": "Terrain generation presets using terrain_generate with Perlin noise",
+    "lastUpdated": "2026-01-30",
+    "totalPresets": 3,
+    "version": "3.0.0",
+    "usage": "Use terrain_generate tool with generation parameters for natural terrain",
+    "defaultGeneration": {
+      "description": "Recommended base values for natural-looking terrain",
+      "baseHeight": 40,
+      "amplitude": 30,
+      "frequency": 0.005,
+      "layers": [
+        { "material": "Water", "maxHeight": 15 },
+        { "material": "Sand", "maxHeight": 22 },
+        { "material": "LeafyGrass", "maxHeight": 50 },
+        { "material": "Ground", "maxHeight": 65 },
+        { "material": "Rock", "maxHeight": 100 }
+      ],
+      "notes": {
+        "baseHeight": "Center height of terrain. Lower = more water, Higher = more land",
+        "amplitude": "Height variation. Lower = flatter, Higher = more dramatic",
+        "frequency": "Noise scale. Lower = smoother/larger features, Higher = rougher/smaller features",
+        "layers": "Material by height. Order from lowest maxHeight to highest"
+      }
+    }
+  },
+  "presets": {
+    "forest_clearing": {
+      "name": "Forest Clearing",
+      "nameKo": "숲 속 빈터",
+      "theme": "forest",
+      "difficulty": "beginner",
+      "description": "Natural forest terrain with gentle hills, grass plains, and scattered water features",
+      "size": {
+        "base": 512,
+        "variants": [256, 512, 1024]
+      },
+      "bounds": {
+        "min": { "x": -256, "y": 0, "z": -256 },
+        "max": { "x": 256, "y": 80, "z": 256 }
+      },
+      "generation": {
+        "baseHeight": { "base": 25, "variance": 3 },
+        "amplitude": { "base": 18, "variance": 4 },
+        "frequency": { "base": 0.008, "variance": 0.002 },
+        "layers": [
+          { "material": "Water", "maxHeight": 10 },
+          { "material": "Sand", "maxHeight": 15 },
+          { "material": "LeafyGrass", "maxHeight": 30 },
+          { "material": "Ground", "maxHeight": 38 },
+          { "material": "Rock", "maxHeight": 80 }
+        ]
+      },
+      "spawnConfig": {
+        "count": 3,
+        "minSpacing": 50,
+        "preferOutdoor": true,
+        "heightOffset": 3,
+        "fallbackSpawns": [
+          { "x": 0, "y": 28, "z": 0 },
+          { "x": 80, "y": 28, "z": -60 },
+          { "x": -60, "y": 28, "z": 80 }
+        ]
+      },
+      "objectSpawnConfig": {
+        "count": 5,
+        "minSpacing": 40,
+        "heightOffset": 2
+      },
+      "focusView": {
+        "distance": 500,
+        "offset": { "x": -350, "y": 250, "z": -250 }
+      },
+      "postProcess": [
+        {
+          "tool": "terrain_smooth",
+          "params": {
+            "region": {
+              "min": { "x": -256, "y": 0, "z": -256 },
+              "max": { "x": 256, "y": 80, "z": 256 }
+            },
+            "intensity": 0.5
+          }
+        }
+      ],
+      "customization": {
+        "scaleFactor": [0.5, 1, 2],
+        "materialSwaps": {
+          "LeafyGrass": ["Grass", "Snow"],
+          "Ground": ["Mud", "Rock"],
+          "Water": ["Ice"]
+        }
+      }
+    },
+    "volcanic_crater": {
+      "name": "Volcanic Crater",
+      "nameKo": "화산 분화구",
+      "theme": "volcanic",
+      "difficulty": "intermediate",
+      "description": "Dramatic volcanic terrain with lava flows, basalt formations, and rocky peaks",
+      "size": {
+        "base": 512,
+        "variants": [256, 512, 1024]
+      },
+      "bounds": {
+        "min": { "x": -256, "y": 0, "z": -256 },
+        "max": { "x": 256, "y": 100, "z": 256 }
+      },
+      "generation": {
+        "baseHeight": { "base": 32, "variance": 3 },
+        "amplitude": { "base": 18, "variance": 3 },
+        "frequency": { "base": 0.005, "variance": 0.001 },
+        "layers": [
+          { "material": "CrackedLava", "maxHeight": 20 },
+          { "material": "Basalt", "maxHeight": 32 },
+          { "material": "Rock", "maxHeight": 50 },
+          { "material": "Slate", "maxHeight": 100 }
+        ]
+      },
+      "spawnConfig": {
+        "count": 3,
+        "minSpacing": 50,
+        "preferOutdoor": true,
+        "heightOffset": 3,
+        "fallbackSpawns": [
+          { "x": 0, "y": 35, "z": 0 },
+          { "x": 80, "y": 35, "z": -60 },
+          { "x": -60, "y": 35, "z": 80 }
+        ]
+      },
+      "objectSpawnConfig": {
+        "count": 5,
+        "minSpacing": 40,
+        "heightOffset": 2
+      },
+      "focusView": {
+        "distance": 500,
+        "offset": { "x": -350, "y": 280, "z": -250 }
+      },
+      "postProcess": [
+        {
+          "tool": "terrain_smooth",
+          "params": {
+            "region": {
+              "min": { "x": -256, "y": 0, "z": -256 },
+              "max": { "x": 256, "y": 100, "z": 256 }
+            },
+            "intensity": 0.4
+          }
+        }
+      ],
+      "customization": {
+        "scaleFactor": [0.5, 1, 2],
+        "materialSwaps": {
+          "CrackedLava": ["Water"],
+          "Basalt": ["Rock", "Slate"],
+          "Slate": ["Snow", "Glacier"]
+        }
+      }
+    },
+    "tropical_island": {
+      "name": "Tropical Island",
+      "nameKo": "열대 섬",
+      "theme": "island",
+      "difficulty": "intermediate",
+      "description": "Island terrain surrounded by water with sandy beaches, lush vegetation, and rocky peaks",
+      "size": {
+        "base": 512,
+        "variants": [256, 512, 1024]
+      },
+      "bounds": {
+        "min": { "x": -256, "y": 0, "z": -256 },
+        "max": { "x": 256, "y": 120, "z": 256 }
+      },
+      "generation": {
+        "baseHeight": { "base": 42, "variance": 5 },
+        "amplitude": { "base": 38, "variance": 5 },
+        "frequency": { "base": 0.003, "variance": 0.001 },
+        "layers": [
+          { "material": "Water", "maxHeight": 25 },
+          { "material": "Sand", "maxHeight": 32 },
+          { "material": "LeafyGrass", "maxHeight": 55 },
+          { "material": "Ground", "maxHeight": 70 },
+          { "material": "Rock", "maxHeight": 120 }
+        ]
+      },
+      "spawnConfig": {
+        "count": 3,
+        "minSpacing": 50,
+        "preferOutdoor": true,
+        "heightOffset": 3,
+        "fallbackSpawns": [
+          { "x": 0, "y": 45, "z": 0 },
+          { "x": 80, "y": 45, "z": -60 },
+          { "x": -60, "y": 45, "z": 80 }
+        ]
+      },
+      "objectSpawnConfig": {
+        "count": 5,
+        "minSpacing": 40,
+        "heightOffset": 2
+      },
+      "focusView": {
+        "distance": 530,
+        "offset": { "x": -40, "y": 355, "z": -390 }
+      },
+      "postProcess": [
+        {
+          "tool": "terrain_smooth",
+          "params": {
+            "region": {
+              "min": { "x": -256, "y": 0, "z": -256 },
+              "max": { "x": 256, "y": 120, "z": 256 }
+            },
+            "intensity": 0.5
+          }
+        }
+      ],
+      "customization": {
+        "scaleFactor": [0.5, 1, 2],
+        "materialSwaps": {
+          "LeafyGrass": ["Grass", "Snow"],
+          "Ground": ["Mud", "Rock"],
+          "Water": ["Ice"]
+        }
+      }
+    }
+  },
+  "materials": {
+    "natural": ["Grass", "LeafyGrass", "Ground", "Mud", "Sand", "Sandstone", "Rock", "Slate", "Basalt", "Snow", "Glacier", "Ice"],
+    "water": ["Water"],
+    "volcanic": ["CrackedLava", "Basalt", "Rock"],
+    "building": ["Concrete", "Pavement", "Brick", "Cobblestone"],
+    "special": ["Neon", "Air"]
+  },
+  "layerPresets": {
+    "forest": [
+      { "material": "Water", "maxHeight": 10 },
+      { "material": "Sand", "maxHeight": 15 },
+      { "material": "LeafyGrass", "maxHeight": 30 },
+      { "material": "Ground", "maxHeight": 38 },
+      { "material": "Rock", "maxHeight": 80 }
+    ],
+    "desert": [
+      { "material": "Water", "maxHeight": 5 },
+      { "material": "Sandstone", "maxHeight": 25 },
+      { "material": "Sand", "maxHeight": 35 },
+      { "material": "Rock", "maxHeight": 80 }
+    ],
+    "snow": [
+      { "material": "Water", "maxHeight": 8 },
+      { "material": "Ice", "maxHeight": 12 },
+      { "material": "Snow", "maxHeight": 40 },
+      { "material": "Glacier", "maxHeight": 80 }
+    ],
+    "volcanic": [
+      { "material": "CrackedLava", "maxHeight": 20 },
+      { "material": "Basalt", "maxHeight": 32 },
+      { "material": "Rock", "maxHeight": 50 },
+      { "material": "Slate", "maxHeight": 100 }
+    ],
+    "island": [
+      { "material": "Water", "maxHeight": 15 },
+      { "material": "Sand", "maxHeight": 22 },
+      { "material": "LeafyGrass", "maxHeight": 55 },
+      { "material": "Ground", "maxHeight": 75 },
+      { "material": "Rock", "maxHeight": 120 }
+    ]
+  }
+}

package/plugins/weppy-roblox-mcp/skills/roblox-templates/assets/monsters.json

@@ -0,0 +1,132 @@
+{
+  "_meta": {
+    "category": "monsters",
+    "description": "RPG monsters and enemy assets with animations",
+    "lastUpdated": "2026-01-30",
+    "totalAssets": 5
+  },
+  "searchHints": {
+    "undead": ["zombie enemy R15", "skeleton warrior", "ghost spirit", "vampire"],
+    "beast": ["wolf animal enemy", "bear animal", "spider enemy", "scorpion"],
+    "humanoid": ["goblin enemy", "orc warrior", "bandit thief", "troll"],
+    "boss": ["dragon boss", "demon boss", "golem boss", "lich undead boss"],
+    "creature": ["slime monster", "bat enemy", "rat enemy", "snake"]
+  },
+  "qualityCriteria": {
+    "preferR15": true,
+    "maxPartCount": 100,
+    "requiresHumanoid": true,
+    "requiresAnimations": true,
+    "freeOnly": true
+  },
+  "defaultFocusView": {
+    "distance": 30,
+    "offset": { "x": 20, "y": 10, "z": 20 }
+  },
+  "assets": [
+    {
+      "id": 3375251681,
+      "name": "Zombie",
+      "type": "undead",
+      "query": "zombie enemy R15",
+      "creator": "Rzepert",
+      "description": "R15 zombie with full animation set",
+      "structure": {
+        "partCount": 16,
+        "meshPartCount": 14,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 15,
+        "animations": 10,
+        "animationList": ["climb", "fall", "idle", "idle2", "jump", "sit", "swim", "swimidle", "toolnone", "walk"]
+      },
+      "focusView": {
+        "distance": 30,
+        "offset": { "x": 20, "y": 10, "z": 20 }
+      }
+    },
+    {
+      "id": 9512936349,
+      "name": "Shadow Monster",
+      "type": "humanoid",
+      "query": "monster NPC killer animated",
+      "creator": "IL_CAPITANO502",
+      "description": "Dark humanoid monster with R6 animations",
+      "structure": {
+        "partCount": 7,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 6,
+        "animations": 9,
+        "animationList": ["climb", "fall", "idle", "idle2", "jump", "run", "sit", "toolnone", "walk"]
+      },
+      "focusView": {
+        "distance": 35,
+        "offset": { "x": 20, "y": 15, "z": 20 }
+      }
+    },
+    {
+      "id": 71129266059717,
+      "name": "Orc Warrior",
+      "type": "humanoid",
+      "query": "R15 orc monster",
+      "creator": "BotDrone_Studios",
+      "description": "R15 orc with full animation set including combat moves",
+      "structure": {
+        "partCount": 16,
+        "meshPartCount": 15,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 15,
+        "animations": 27,
+        "animationList": ["mood", "cheer", "climb", "dance", "dance2", "dance3", "fall", "idle", "idle2", "jump", "laugh", "point", "run", "sit", "swim", "swimidle", "toollunge", "toolnone", "toolslash", "walk", "wave"]
+      },
+      "focusView": {
+        "distance": 30,
+        "offset": { "x": 20, "y": 10, "z": 20 }
+      }
+    },
+    {
+      "id": 5217586235,
+      "name": "Green Zombie",
+      "type": "undead",
+      "query": "zombie R15 animated",
+      "creator": "Think_yDev",
+      "description": "Alternative R15 zombie with animations",
+      "structure": {
+        "partCount": 16,
+        "meshPartCount": 14,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 15,
+        "animations": 10,
+        "animationList": ["climb", "fall", "idle", "idle2", "jump", "sit", "swim", "swimidle", "toolnone", "walk"]
+      },
+      "focusView": {
+        "distance": 30,
+        "offset": { "x": 20, "y": 10, "z": 20 }
+      }
+    },
+    {
+      "id": 103446417026847,
+      "name": "Earth Golem",
+      "type": "boss",
+      "query": "golem boss animated",
+      "creator": "AtomicEvilMango",
+      "description": "Large golem boss with full animation set",
+      "structure": {
+        "partCount": 16,
+        "meshPartCount": 15,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 15,
+        "animations": 27,
+        "animationList": ["mood", "cheer", "climb", "dance", "dance2", "dance3", "fall", "idle", "idle2", "jump", "laugh", "point", "run", "sit", "swim", "swimidle", "toollunge", "toolnone", "toolslash", "walk", "wave"]
+      },
+      "focusView": {
+        "distance": 45,
+        "offset": { "x": 25, "y": 15, "z": 25 }
+      }
+    }
+  ]
+}

package/plugins/weppy-roblox-mcp/skills/roblox-templates/assets/npcs.json

@@ -0,0 +1,50 @@
+{
+  "_meta": {
+    "category": "npcs",
+    "description": "RPG NPC characters with animations. For more options, monsters assets can also be used as NPCs with different behavior scripts.",
+    "lastUpdated": "2026-01-30",
+    "totalAssets": 1,
+    "note": "monsters.json assets are compatible as NPCs - same R15/R6 structure with animations"
+  },
+  "searchHints": {
+    "villager": ["villager npc", "peasant farmer", "citizen townfolk"],
+    "merchant": ["merchant trader shop", "shopkeeper npc", "vendor"],
+    "quest": ["quest giver npc", "sage elder", "guild master"],
+    "service": ["blacksmith npc", "alchemist potion", "innkeeper tavern"],
+    "guard": ["guard knight soldier", "guard npc", "patrol soldier"]
+  },
+  "qualityCriteria": {
+    "preferR15": true,
+    "requiresHumanoid": true,
+    "requiresAnimations": true,
+    "freeOnly": true
+  },
+  "defaultFocusView": {
+    "distance": 25,
+    "offset": { "x": 18, "y": 8, "z": 18 }
+  },
+  "sharedWith": ["monsters"],
+  "assets": [
+    {
+      "id": 11219356175,
+      "name": "The NPC",
+      "type": "villager",
+      "query": "NPC animated R6",
+      "creator": "meisson20",
+      "description": "Basic R6 NPC with full animation set and AI scripts",
+      "structure": {
+        "partCount": 10,
+        "hasHumanoid": true,
+        "hasScripts": true,
+        "motor6D": 6,
+        "animations": 9,
+        "animationList": ["climb", "fall", "idle", "idle2", "jump", "run", "sit", "toolnone", "walk"],
+        "hasSounds": true
+      },
+      "focusView": {
+        "distance": 25,
+        "offset": { "x": 18, "y": 8, "z": 18 }
+      }
+    }
+  ]
+}

package/plugins/weppy-roblox-mcp/skills/roblox-templates/assets/weapons.json

@@ -0,0 +1,140 @@
+{
+  "_meta": {
+    "category": "weapons",
+    "description": "RPG weapon assets",
+    "lastUpdated": "2026-01-30",
+    "totalAssets": 3
+  },
+  "searchHints": {
+    "melee": [
+      "sword weapon tool",
+      "axe weapon",
+      "dagger knife",
+      "spear weapon",
+      "mace weapon"
+    ],
+    "ranged": [
+      "bow arrow weapon",
+      "crossbow weapon",
+      "throwing knife"
+    ],
+    "magic": [
+      "magic staff wizard",
+      "magic wand",
+      "fire staff",
+      "ice staff frost"
+    ],
+    "defense": [
+      "shield defense",
+      "wooden shield",
+      "iron shield"
+    ]
+  },
+  "qualityCriteria": {
+    "requiresHandle": true,
+    "requiresTool": true,
+    "maxPartCount": 50,
+    "freeOnly": true
+  },
+  "defaultFocusView": {
+    "distance": 15,
+    "offset": {
+      "x": 8,
+      "y": 5,
+      "z": 12
+    }
+  },
+  "assets": [
+    {
+      "id": 65524795,
+      "name": "Thunder Staff of Pwnage",
+      "type": "magic",
+      "query": "magic staff wizard",
+      "creator": "TheCoolDog",
+      "description": "Lightning staff, no reload time",
+      "structure": {
+        "className": "Tool",
+        "partCount": 1,
+        "hasScripts": true,
+        "hasSound": true,
+        "hasHandle": true,
+        "hasSpecialMesh": true,
+        "boundingBox": {
+          "x": 0.7,
+          "y": 0.5,
+          "z": 6.75
+        }
+      },
+      "focusView": {
+        "distance": 15,
+        "offset": {
+          "x": 8,
+          "y": 5,
+          "z": 12
+        }
+      }
+    },
+    {
+      "id": 2160618177,
+      "name": "Classic Sword",
+      "type": "melee",
+      "query": "classic sword",
+      "creator": "Doodlemeyer",
+      "description": "Classic Roblox sword, simple and reliable",
+      "structure": {
+        "className": "Tool",
+        "partCount": 1,
+        "hasScripts": true,
+        "hasHandle": true,
+        "hasSpecialMesh": true,
+        "boundingBox": {
+          "x": 1,
+          "y": 0.8,
+          "z": 4
+        }
+      },
+      "focusView": {
+        "distance": 10,
+        "offset": {
+          "x": 8,
+          "y": 5,
+          "z": 12
+        }
+      }
+    },
+    {
+      "id": 2304105204,
+      "name": "Classic Sword (FE)",
+      "type": "melee",
+      "query": "classic sword",
+      "creator": "TunacanGamer",
+      "description": "FilteringEnabled compatible classic sword with trail effect",
+      "recommended": true,
+      "structure": {
+        "className": "Tool",
+        "partCount": 1,
+        "hasScripts": true,
+        "hasHandle": true,
+        "hasSpecialMesh": true,
+        "moduleScripts": 13,
+        "hasConfiguration": true,
+        "hasRemoteEvent": true,
+        "hasTrail": true,
+        "hasSounds": true,
+        "boundingBox": {
+          "x": 1,
+          "y": 0.8,
+          "z": 4
+        }
+      },
+      "focusView": {
+        "distance": 10,
+        "offset": {
+          "x": 8,
+          "y": 5,
+          "z": 12
+        }
+      }
+    }
+  ]
+}

package/plugins/weppy-roblox-mcp/skills/roblox-templates/references/animations.json

@@ -0,0 +1,40 @@
+{
+  "_meta": {
+    "category": "animations",
+    "description": "Default R15 animation IDs",
+    "lastUpdated": "2025-01-28",
+    "source": "Roblox Default R15 Animations"
+  },
+  "r15": {
+    "movement": {
+      "idle": "rbxassetid://507766666",
+      "walk": "rbxassetid://507777826",
+      "run": "rbxassetid://507767714",
+      "jump": "rbxassetid://507765000",
+      "fall": "rbxassetid://507767968",
+      "climb": "rbxassetid://507765644",
+      "swimIdle": "rbxassetid://507784897",
+      "swim": "rbxassetid://507785072"
+    },
+    "combat": {
+      "punch": "rbxassetid://507770818",
+      "slash": "rbxassetid://522635514",
+      "lunge": "rbxassetid://522638767",
+      "toolNone": "rbxassetid://507768375"
+    },
+    "emotes": {
+      "wave": "rbxassetid://507770239",
+      "laugh": "rbxassetid://507770818",
+      "cheer": "rbxassetid://507770677",
+      "point": "rbxassetid://507770453",
+      "dance": "rbxassetid://507771019",
+      "dance2": "rbxassetid://507776043",
+      "dance3": "rbxassetid://507777268"
+    },
+    "states": {
+      "sit": "rbxassetid://507768133",
+      "death": "rbxassetid://507772104",
+      "gettingUp": "rbxassetid://507768335"
+    }
+  }
+}