Common questions

Q1. How to import items from other plugins?

Hold the item in hand and run /cfishing items import test_item, you will find the exported item at CustomFishing/imported_items.yml, then you can copy and paste the exported data to the place you want.

Q2. How to use the vanilla 1.20.5+ custom durability?

Firstly, delete the max-durability provided by the plugin so they would not conflict. Then use components section to add the max_damage property to the item. You can read this page for example

Item

Q3. How to use items/blocks from other plugins?

in config.yml there's a section like this, let's take items as example

# CustomFishing supports using items/blocks from other plugins
# If items share the same id, they would inherit the effects
item-detection-order:
  - CustomFishing
  - vanilla
block-detection-order:
  - vanilla

For instance if you have ItemsAdder installed, and you want CustomFishing to check ItemsAdder's ID, you can add ItemsAdder to the order:

item-detection-order:
  - ItemsAdder
  - CustomFishing
  - vanilla

However, the items in ItemsAdder all have namespaces, so in order to ensure that the IDs correspond, you need to modify the fishing rod configuration of Custom Fishing

namespace:beginner_rod:
  material: ItemsAdder:namespace:beginner_rod
  effects:
    effect_1:
      type: wait-time-multiplier
      value: 1.5
    effect_2:
      type: difficulty
      value: -8

If you have MMOItems installed, you can configure like this (The capitalization used here is because MMOItems will convert all IDs to uppercase)

item-detection-order:
  - MMOItems
  - CustomFishing
  - vanilla

BEGINNER_ROD:
  material: MMOItems:TOOL:BEGINNER_ROD
  effects:
    effect_1:
      type: wait-time-multiplier
      value: 1.5
    effect_2:
      type: difficulty
      value: -8

If you have Oraxen installed, you can configure like this

item-detection-order:
  - Oraxen
  - CustomFishing
  - vanilla

beginner_rod:
  material: Oraxen:beginner_rod
  effects:
    effect_1:
      type: wait-time-multiplier
      value: 1.5
    effect_2:
      type: difficulty
      value: -8

Q4. How to integrate my leveler plugin with CustomFishing?

Some leveler plugins may provide skill modification fishing mechanisms, and in this regard, Custom Fishing is powerless unless both developers work together. But in most cases, those attribute gains can be applied to Customs Fishing as long as the plugins provide corresponding attribute variables and skill level variables. You can refer to this page for some examples

Placeholder & Expression

Q5. Why can't I have minigames?

If you have MMOCore installed, then your fishing mechanic would be like the picture below. The way to resolve the issue is deleting the fishing profession provided by MMOCore through deleting the YAML config.

Q6. How to enable void-fishing mechanic?

Void fishing is a special mechanic registered by CustomFishing API. It allows registering any hook mechanic as you want if you know a little about coding. Firstly configure loots in loot-conditions.yml for the void for instance

global-group:
  list: []
  conditions: {}
  sub-groups:
    loots_in_void:
      conditions:
        in-void: true
        environment:
          - the_end
      list:
        - rubbish:+5

Then create an effect that allows void-fishing at the place you want. In this case I'm using the global-effects in config.yml

mechanics:
  global-effects:
    void_fishing:
      type: void-fishing

Now you can fish in void!

void fishing

Q7. Why TOTAL_SCORE competition not works?

You need to configure the score for each fish for this to work properly.

Loot (See competition score on this page)