Skip to content

Custom Models

Jump to bottom
ItsHarshXD edited this page Jun 14, 2024 · 2 revisions

Custom Models

MatrixGliders supports custom models for gliders using either ItemsAdder, Oraxen, or Custom Model Data. Follow the instructions below to enable the desired custom model feature.

ItemsAdder

To enable ItemsAdder support for custom glider models, follow these steps:

  1. Ensure that ItemsAdder is installed on your server. If not, you can download it from here.
  2. In your gliders.yml configuration file, locate the glider you want to set a custom model for.
  3. Under item-settings.itemsadder, set enabled to true.
  4. Specify the item-id of the glider in the item-settings.itemsadder section.

Example configuration for ItemsAdder:

common-glider: # The unique identifier string for this glider. (Make sure it unique and not set to other gliders)
  glider-name: '<SOLID:FF0000>Common Glider' # Display name for the glider, which will be shown in gliders menu.
  lore:
    enabled: true
    lines:
      - '&7Common'
      - '&r'
      - '&8Default Glider for every players.'
  item-settings:
    itemsadder:
      enabled: true # When enabled, this glider will utilize the ItemsAdder hook to acquire both model and textures.
      item-id: common-glider # ItemsAdder's item instance ID to acquire its model as well as textures. (The specified ItemsAdder's item must present to hook into it.)
    oraxen:
      enabled: false # When enabled, this glider will utilize the Oraxen hook to acquire both model and textures.
      item-id: common-glider # Oraxen's item instance ID to acquire its model as well as textures. (The specified Oraxen's item must present to hook into it.)
    custom-model-data:
      enabled: false # When enabled, this glider will utilize the server texture pack hook to acquire both model and textures.
      model-id: 1001 # Server texture pack's item's custom model data ID to acquire its model as well as textures. (The specified Custom Model Data's item must present to hook into it.)
      material: PAPER # The item on which the specified custom model data ID is hooked.

Oraxen

To enable Oraxen support for custom glider models, follow these steps:

  1. Ensure that Oraxen is installed on your server. If not, you can download it from here.
  2. In your gliders.yml configuration file, locate the glider you want to set a custom model for.
  3. Under item-settings.oraxen, set enabled to true.
  4. Specify the item-id of the glider in the item-settings.oraxen section.

Example configuration for Oraxen:

common-glider: # The unique identifier string for this glider. (Make sure it unique and not set to other gliders)
  glider-name: '<SOLID:FF0000>Common Glider' # Display name for the glider, which will be shown in gliders menu.
  lore:
    enabled: true
    lines:
      - '&7Common'
      - '&r'
      - '&8Default Glider for every players.'
  item-settings:
    itemsadder:
      enabled: false # When enabled, this glider will utilize the ItemsAdder hook to acquire both model and textures.
      item-id: common-glider # ItemsAdder's item instance ID to acquire its model as well as textures. (The specified ItemsAdder's item must present to hook into it.)
    oraxen:
      enabled: true # When enabled, this glider will utilize the Oraxen hook to acquire both model and textures.
      item-id: common-glider # Oraxen's item instance ID to acquire its model as well as textures. (The specified Oraxen's item must present to hook into it.)
    custom-model-data:
      enabled: false # When enabled, this glider will utilize the server texture pack hook to acquire both model and textures.
      model-id: 1001 # Server texture pack's item's custom model data ID to acquire its model as well as textures. (The specified Custom Model Data's item must present to hook into it.)
      material: PAPER # The item on which the specified custom model data ID is hooked.

Custom Model Data

To enable Custom Model Data support for custom glider models, follow these steps:

  1. In your gliders.yml configuration file, locate the glider you want to set a custom model for.
  2. Under item-settings.custom-model-data, set enabled to true.
  3. Specify the 'model-id' and 'material' of the glider in the 'item-settings.custom-model-data' section.

Example configuration for Oraxen:

common-glider: # The unique identifier string for this glider. (Make sure it unique and not set to other gliders)
  glider-name: '<SOLID:FF0000>Common Glider' # Display name for the glider, which will be shown in gliders menu.
  lore:
    enabled: true
    lines:
      - '&7Common'
      - '&r'
      - '&8Default Glider for every players.'
  item-settings:
    itemsadder:
      enabled: false # When enabled, this glider will utilize the ItemsAdder hook to acquire both model and textures.
      item-id: common-glider # ItemsAdder's item instance ID to acquire its model as well as textures. (The specified ItemsAdder's item must present to hook into it.)
    oraxen:
      enabled: false # When enabled, this glider will utilize the Oraxen hook to acquire both model and textures.
      item-id: common-glider # Oraxen's item instance ID to acquire its model as well as textures. (The specified Oraxen's item must present to hook into it.)
    custom-model-data:
      enabled: true # When enabled, this glider will utilize the server texture pack hook to acquire both model and textures.
      model-id: 1001 # Server texture pack's item's custom model data ID to acquire its model as well as textures. (The specified Custom Model Data's item must present to hook into it.)
      material: PAPER # The item on which the specified custom model data ID is hooked.
Clone this wiki locally