Skip to content

Configuration Guide & Recommendations

Jump to bottom
LOOHP edited this page Sep 22, 2024 · 5 revisions

Prizes Allocation and Odds Calculator

An interactive calculator for prize allocation, prize qualification, chance and bet prices.

Configs in Different Languages

Note that configs in languages other than English might be out of date.

Overview

Recommendations made on this page are related to the LotterySix section of the config, they are the main settings for your LotterSix games.

Scheduling Games

LotterySix:
  # CornJob expression, https://crontab.guru/
  # How often should the lottery run
  # Put "Never" to never run automatically
  RunInterval: "0 22 * * 2,4,6"
  TimeZone: "Asia/Hong_Kong"
  # How long before the lottery runs after it had started
  # Setting this to a negative value refers to
  # N seconds before the next scheduled round
  # If RunInterval is "Never",
  # A negative value will be treated as positive
  # This is in seconds
  BetsAcceptDuration: -1800

These three settings control how LotterySix games are automatically scheduled. For the list of timezones, click here.
RunInterval is at what time a new game should begin accepting bets, provided that no game is already running. Use this handy tool to help you create your cron expression.
BetsAcceptDuration is a bit more complicated, it is as follows:

  • If it is a positive value, it refers to how many seconds should a game last after it began until it is closed and the number draw begins
  • If it is a negative value, it schedules a game to end and start the draw at X amount of seconds before the next scheduled game begins

In the default config above, for example, a game is started at 22:00 at night every Tuesday, Thursday and Saturday, and ends at 1800 seconds (30 minutes) before the next scheduled game begins. In other words, if a game started at 22:00 on a Tuesday, it will end at 21:30 on the following Thursday.

Betting Price

LotterySix:
  # This must be a positive EVEN integer
  # If it isn't, it would be rounded up
  PricePerBet: 10

This controls how much a unit bet (or in other words, 1 bet) costs. It must be a positive EVEN integer.

Game Chance (Odds)

LotterySix:
  # Number Of Number Choices, Starting from 1, Inclusive
  # The lower the number of choices, the higher the odds
  # Minimum is 7, Maximum is 49
  NumberOfChoices: 39

This controls the range of numbers players can choose from when placing their bets. This directly influences the chance of your LotterySix games. (How easy/hard it is to win prizes)
You can use the LotterySix Calculator to choose the range of numbers for your server, it will show you what are the odds of each prize tier for any given NumberOfChoices.

Prize Calculation

LotterySix:
  # The lowest prize allocation for winning the top three tiers
  # Ideally you want this value to be MUCH LOWER than
  # the price for betting all numbers divided by 0.45,
  # so you don't win more if you bet every number
  # (MUCH LOWER is still pretty high for high number of choices)
  LowestTopPlacesPrize: 8000000
  # Prize Calculation Mode
  # This affects carry over prize calculation as well
  # HKJC mode is an IRL prize money calculation method used by the HKJC
  # Where the LowestTopPlacesPrize is only applied to 1st tier instead of all 1st - 3rd
  # NOT recommended unless you have a large server that buys a LOT of tickets (>50000)
  # MODES: UNREALISTIC_FOR_FUN, HKJC
  PrizeCalculationMode: UNREALISTIC_FOR_FUN

This controls the prize money allocation and how the prize money is calculated, it mostly influences the top 3 tiers.

  • With UNREALISTIC_FOR_FUN (Named DEFAULT before version 1.10.17.1), LowestTopPlacesPrize refers to the total prize fund allocated to all top 3 tiers
  • With HKJC, LowestTopPlacesPrize is only given to the 1st tier (jackpot) and all other tiers only use the money from ticket sales. Therefore, if you don't have a lot of ticket sales, this mode wouldn't work very well

You can again use the LotterySix Calculator, input your PricePerBet and NumberOfChoices then click the Recommended Lowest Top Prize Cal., it will suggest a good LowestTopPlacesPrize for you.
For more information on how prize calculation works, you can read this page.

Carry-Over Calculation

LotterySix:
  # Choose carry-over fund calculation mode
  # The difference between DEFAULT & ONLY_TICKET_SALES is that the for
  # ONLY_TICKET_SALES that half of LowestTopPlacesPrize does not carry over to the next game
  # MODES: ONLY_TICKET_SALES, PRIZE_AND_SALES
  CarryOverMode: ONLY_TICKET_SALES

This controls how money is carry-over to the next round of LotterySix if there are turnovers left not given out as prize money.

  • With ONLY_TICKET_SALES, the LowestTopPlacesPrize will be removed from the leftovers before carrying over to the next round.
  • With PRIZE_AND_SALES (Named DEFAULT before version 1.10.17.1), all of the leftovers including the LowestTopPlacesPrize will be carried over

For example, if the LowestTopPlacesPrize is $8,000,000 and the turnover (after tax) is $1,000 and no one wins any prizes.
If on DEFAULT mode, all $8,000,000 + $1,000 will be carried over. Whereas in ONLY_TICKET_SALES mode, only $1,000 will be carried over.
For more information on how prize calculation works, you can read this page.

Config Placeholders

You may check out this page for available placeholders in specific config fields related to the GUI text or chat display messages.

Clone this wiki locally