🔀Random Placeholder - Premium

We added {random} built-in placeholder in premium version.

Configure

• Open config.yml, find below contents:

placeholder:
  # Premium version only.
  random:
    rotate:
      reset-mode: TIMED
      reset-time: '00:00:00'
      elements:
        - 'A'
        - 'B'
        - 'C'
    daily-shop:
      reset-mode: TIMED
      reset-time: '00:00:00'
      elements:
        - 'rotate' # This means this placeholder will include all rotate placeholder elements.

Change the value you'd like.

• reset-mode/reset-time: Please view below to know.

• element-amount: The amount of the element will picked. (Added in 3.1.0)

• elements: The random element what placeholder will picked.

  • Support use ~ symbol means pick random number, for example, 5~100 means pick one random number from 5 to 100.

placeholder:
  # Premium version only.
  random:
    rotate:
      reset-mode: TIMED
      reset-time: '00:00:00'
      elements:
        - 'A'
        - 'B'
        - 'C'
    daily-shop:
      reset-mode: TIMED
      reset-time: '00:00:00'
      element-amount: 2
      elements:
        - 'A'
        - 'B'
        - 'C'

Use Placeholder

Use {random_<ID>;;<Number>} placeholder to display it's value, like {random_daily;;2} will query daily random placeholder's second element picked. For more info, please view Placeholders page. For example of this placeholder usage, please view Daily Shop page.

Reset Placeholder

You can reset placeholder by setting reset-mode and reset-time option.

Supports below reset mode:

• ONCE: Each time it is used, it will reset and is not applicable to the price, as the price seen by the player opening the store and the actual transaction result are calculated twice, so you cannot achieve price synchronization.

• TIMER/TIMED/NEVER: Please view this page to know more. We will generate reset time after random placeholder be used once. The reset time will not automatically adjust based on configuration updates. If you set the reset time incorrectly, you will need to delete the corresponding data.

For more info, please view this page.

Example: Random Price

Create new random placeholder

In this example, we create a new random placeholder called price at config.yml.

  random:
    price:
      reset-mode: TIMED
      reset-time: '00:00:00'
      elements:
        # Random number from 5 to 100.
        - '5~100'

Set dynamic value in your product configs

Use {random_price} placeholder at any product's price config. Like I add this placeholder in this product:

items:
  A:
    price-mode: CLASSIC_ALL
    product-mode: CLASSIC_ALL
    products:
      1:
        material: coal
        amount: 1
    buy-prices:
      1:
        economy-plugin: Vault
        amount: '{random_price}' # <--- Changed line
        placeholder: '&6{amount} Coins'
        start-apply: 0
    buy-limits:
      global: 320
      default: 240
      vip: 320
    buy-limits-conditions:
      vip:
        - 'permission: group.vip'
    buy-limits-reset-mode: 'TIMED'
    buy-limits-reset-time: '00:00:00'