Cobblemon là mod Minecraft tích hợp Pokémon vào game một cách tự nhiên, dựa trên hệ thống tài nguyên và datapack của Minecraft để cung cấp khả năng tùy chỉnh tối đa. Một trong những ưu điểm chính của cách tiếp cận này là khả năng sửa đổi hoàn toàn logic spawn Pokémon mà không cần chạm vào mã nguồn của mod. Với một datapack được cấu trúc tốt, quản trị viên máy chủ hoặc người tạo modpack có thể kiểm soát chính xác Pokémon nào xuất hiện, trong biome nào, với điều kiện gì và với tần suất bao nhiêu.

Hướng dẫn kỹ thuật này dành cho các quản trị viên máy chủ Cobblemon và người tạo modpack muốn nắm vững hệ thống spawn tùy chỉnh của mod. Chúng ta sẽ cùng xem cách cấu trúc datapack, hiểu định dạng JSON của các tệp spawn và triển khai trên máy chủ sản xuất.

Tại sao nên tùy chỉnh spawn với datapack?

Theo mặc định, Cobblemon tạo các tệp spawn của riêng nó cho tất cả các thế hệ Pokémon (Gen 1 đến Gen 9). Các tệp này xác định các điều kiện trong đó mỗi loài có thể xuất hiện trong thế giới. Tuy nhiên, nhiều tình huống biện minh cho việc tạo datapack spawn tùy chỉnh:

  • Cân bằng lại sự hiếm: một Pokémon có thể quá phổ biến hoặc quá hiếm trong cấu hình biome của bạn.
  • Thêm spawn theo chủ đề: làm xuất hiện Pokémon dưới nước chỉ trong các biome đại dương cụ thể của modpack.
  • Tạo khu vực độc quyền: dành riêng một số Pokémon cho các chiều hoặc cấu trúc cụ thể.
  • Xóa spawn không mong muốn: vô hiệu hóa sự xuất hiện của một số loài vì lý do cân bằng.
  • Đồng bộ với mod bên thứ ba: tích hợp các biome được thêm bởi mod như Terralith hoặc BYG vào logic spawn.

Các datapack Cobblemon hoàn toàn tương thích với tải lại nóng qua lệnh /reload, giúp dễ dàng gỡ lỗi và điều chỉnh trực tiếp.

Cấu trúc của datapack Cobblemon

Datapack Minecraft tiêu chuẩn tuân theo một hệ thống thư mục phân cấp chính xác. Đối với Cobblemon, các tệp spawn được đặt trong thư mục con cụ thể. Đây là cấu trúc tối thiểu cần tuân theo:

mon-datapack/
├── pack.mcmeta
└── data/
    └── cobblemon/
        └── spawn_pool_world/
            ├── bulbasaur.json
            ├── pikachu.json
            └── ...

Tệp pack.mcmeta phải chứa tối thiểu:

{
  "pack": {
    "pack_format": 15,
    "description": "Spawn tùy chỉnh Cobblemon"
  }
}

Điều chỉnh giá trị pack_format theo phiên bản Minecraft bạn đang sử dụng (15 cho 1.20.x, 18 cho 1.21.x). Thư mục spawn_pool_world là thư mục mà Cobblemon giám sát để tải các quy tắc spawn trong thế giới chính. Cũng có spawn_pool_nether và spawn_pool_end cho các chiều tương ứng.

Cấu tạo tệp JSON spawn

Mỗi tệp JSON spawn có thể chứa nhiều mục cho cùng một Pokémon hoặc nhiều loài. Đây là ví dụ có chú thích cho Pikachu:

{
  "enabled": true,
  "neededInstalledMods": [],
  "neededUninstalledMods": [],
  "spawns": [
    {
      "id": "cobblemon:pikachu_forest",
      "pokemon": "pikachu",
      "type": "land",
      "context": "grounded",
      "bucket": "uncommon",
      "level": "10-25",
      "weight": 8.0,
      "condition": {
        "biomes": [
          "#minecraft:is_forest"
        ],
        "timeRange": "any",
        "isRaining": false,
        "minY": 60,
        "maxY": 120
      },
      "anticondition": {
        "structures": ["#minecraft:villages"]
      }
    }
  ]
}

Các trường cần thiết

  • id: định danh duy nhất của quy tắc, theo định dạng namespace:tên_mô_tả. Nó phải là duy nhất trong toàn bộ datapack.
  • pokemon: tên nội bộ của Pokémon bằng chữ thường, như nó xuất hiện trong Cobblemon (ví dụ: bulbasaur, garchomp, iron_bundle).
  • type: chế độ di chuyển của spawn. Các giá trị có thể: land, water, water_surface, underwater, air, lava.
  • context: ngữ cảnh bổ sung. Đối với land, sử dụng grounded. Đối với Pokémon bay, sử dụng flying.
  • bucket: danh mục hiếm. Các giá trị được nhận biết là common, uncommon, rare và ultra_rare.
  • level: phạm vi cấp độ của Pokémon được spawn, theo định dạng "min-max".
  • weight: trọng lượng tương đối trong bucket. Giá trị này càng cao so với các mục khác trong cùng bucket, Pokémon càng thường xuyên xuất hiện hơn.

Khối condition

Trường condition là trung tâm của tùy chỉnh. Nó chấp nhận nhiều tham số:

  • biomes: danh sách biome hoặc tag biome. Các tag bắt đầu bằng # (ví dụ: #minecraft:is_ocean, #forge:is_hot, hoặc tag của mod như #terralith:tropical_island).
  • structures: danh sách cấu trúc trong đó spawn được phép (ví dụ: minecraft:stronghold).
  • timeRange: phạm vi thời gian. Giá trị: any, day, night, dawn, dusk.
  • minY / maxY: độ cao tối thiểu và tối đa của spawn.
  • minLight / maxLight: mức ánh sáng tối thiểu và tối đa (0-15).
  • isRaining: boolean, true để hạn chế spawn khi mưa.
  • isThundering: boolean, chỉ cho bão.
  • moonPhase: giai đoạn trăng (0 = trăng tròn, số nguyên 0-7).
  • nearbyBlocks: danh sách khối phải có mặt gần điểm spawn.

Khối anticondition

Trường anticondition hoạt động như condition nhưng ngược lại: nếu một trong các điều kiện anticondition được đáp ứng, spawn bị chặn. Điều này cho phép, chẳng hạn, ngăn Pokémon spawn bên trong cấu trúc trong khi vẫn để nó spawn trong biome chứa cấu trúc đó.

Các trường hợp tùy chỉnh thực tế

Trường hợp 1: Pokémon độc quyền cho biome mod

Nếu bạn sử dụng Terralith, bạn có thể làm xuất hiện Sneasel chỉ trong biome terralith:snowy_badlands:

{
  "spawns": [
    {
      "id": "monpack:sneasel_snowy_badlands",
      "pokemon": "sneasel",
      "type": "land",
      "context": "grounded",
      "bucket": "rare",
      "level": "25-40",
      "weight": 5.0,
      "condition": {
        "biomes": ["terralith:snowy_badlands"]
      }
    }
  ]
}

Trường hợp 2: Spawn ban đêm có điều kiện

Để làm xuất hiện Haunter chỉ vào ban đêm, trong hang động hoặc khu vực tối:

{
  "spawns": [
    {
      "id": "monpack:haunter_cave_night",
      "pokemon": "haunter",
      "type": "land",
      "context": "grounded",
      "bucket": "rare",
      "level": "20-35",
      "weight": 4.0,
      "condition": {
        "timeRange": "night",
        "maxY": 50,
        "maxLight": 3
      }
    }
  ]
}

Trường hợp 3: Vô hiệu hóa spawn hiện có

Để vô hiệu hóa spawn gốc của Cobblemon, hãy tạo tệp JSON với "enabled": false và cùng định danh với quy tắc gốc. Cobblemon hợp nhất các datapack và datapack người dùng có ưu tiên hơn dữ liệu tích hợp:

{
  "enabled": false,
  "spawns": [
    {
      "id": "cobblemon:magikarp_river"
    }
  ]
}

Lưu ý: bạn phải biết định danh chính xác của quy tắc gốc. Chúng có thể được tham khảo trong mã nguồn của mod trên kho lưu trữ GitLab chính thức của Cobblemon, hoặc bằng cách trích xuất JAR của mod.

Spawn dạng và biến thể

Cobblemon hỗ trợ các dạng Pokémon trực tiếp trong các tệp spawn. Để nhắm mục tiêu dạng cụ thể, thêm dạng sau tên Pokémon:

"pokemon": "rattata form=alolan"

Bạn cũng có thể thêm các khía cạnh hình ảnh hoặc bộ sửa đổi:

"pokemon": "pikachu aspects=[original_cap]"

Các thuộc tính được chấp nhận trong trường pokemon tuân theo cú pháp lệnh Cobblemon và cho phép chỉ định giới tính, cấp độ, chiêu thức đặc biệt hoặc bất kỳ thuộc tính nào khác được mod nhận biết.

Triển khai trên máy chủ

Sau khi tạo và kiểm tra datapack ở local, việc triển khai trên máy chủ Cobblemon theo quy trình đơn giản:

  1. Nén thành ZIP: thư mục mon-datapack/ phải được nén thành mon-datapack.zip. Gốc của archive phải chứa trực tiếp pack.mcmeta và thư mục data/.
  2. Đặt vào đúng thư mục: trên máy chủ Minecraft, datapacks được đặt trong world/datapacks/ (hoặc world_nether/datapacks/ cho Nether).
  3. Kích hoạt datapack: khi khởi chạy lần đầu hoặc sau /reload, thực thi /datapack enable "file/mon-datapack.zip" nếu datapack không được kích hoạt tự động.
  4. Tải lại spawn: chạy /reload để Cobblemon tải lại tất cả các tệp spawn. Không cần khởi động lại máy chủ.

Trên các bảng điều khiển như PteroPilot hoặc Pterodactyl, bạn có thể tải lên ZIP trực tiếp qua trình quản lý tệp web hoặc qua SFTP trong thư mục world/datapacks/.

Xác minh tải datapack

Để xác nhận datapack đã được tải và đang hoạt động:

  • Lệnh /datapack list: liệt kê tất cả datapack đang hoạt động. Datapack của bạn phải xuất hiện với tên của nó.
  • Log máy chủ: khi khởi động hoặc sau /reload, Cobblemon hiển thị thông báo cho biết số quy tắc spawn đã tải.
  • Lệnh Cobblemon /cobblemon spawnpool (nếu có): cho phép kiểm tra pool spawn hiện tại tại vị trí của bạn.

Thực hành tốt và bẫy cần tránh

Xung đột định danh

Hai quy tắc có cùng id ghi đè lẫn nhau. Điều này hữu ích để vô hiệu hóa spawn gốc, nhưng có thể gây ra hành vi không mong muốn nếu hai datapack trên máy chủ của bạn vô tình định nghĩa cùng một định danh. Luôn sử dụng namespace duy nhất cho các định danh của bạn (ví dụ: maychucua:...).

Trọng lượng và bucket

Hệ thống trọng lượng hoạt động theo bucket, không toàn cục. Pokémon với weight là 100 trong bucket ultra_rare không nhất thiết phổ biến: xác suất chọn bucket ultra_rare vẫn thấp. Điều chỉnh bucket trước, sau đó trọng lượng trong bucket.

Tag biome không được nhận biết

Nếu tag biome trong điều kiện của bạn không tồn tại trong phiên bản của bạn (ví dụ, tag của mod không được cài đặt), quy tắc spawn có thể bị bỏ qua im lặng hoặc tạo ra lỗi. Luôn kiểm tra rằng các mod định nghĩa tag bạn sử dụng có trên máy chủ.

Hiệu suất

Số lượng lớn quy tắc spawn phức tạp có thể ảnh hưởng nhẹ đến hiệu suất máy chủ, đặc biệt với các điều kiện liên quan đến tìm kiếm khối gần đó. Hạn chế sử dụng nearbyBlocks cho các trường hợp thực sự cần thiết và kiểm tra hiệu suất bằng các công cụ profiling như Spark trước khi triển khai sản xuất.

Tìm hiểu thêm

Sau khi nắm vững những điều cơ bản, bạn có thể khám phá các tính năng nâng cao của Cobblemon như spawn có điều kiện liên kết với các sự kiện game, tích hợp với plugin máy chủ qua API Cobblemon, hoặc tạo Pokémon boss với các quy tắc spawn chuyên dụng. Hãy tham khảo thêm hướng dẫn của chúng tôi về cấu hình hoàn chỉnh máy chủ Cobblemon để có cách tiếp cận toàn diện về quản trị.

Hệ thống datapack của Cobblemon là một trong những hệ thống linh hoạt nhất hiện có trong số các mod Pokémon cho Minecraft. Bằng cách dành thời gian hiểu cấu trúc JSON và các tham số điều kiện, bạn có toàn quyền kiểm soát hệ sinh thái Pokémon của máy chủ, mà không phụ thuộc vào các bản cập nhật mod cho việc điều chỉnh cân bằng.


Posted on tháng 6 23, 2026 by _Xios_
https://pixelmongo.fr
Loading...