Features

Stock Bulletin

The 1899 stock bulletin: server-made prices, buying and selling shares, holdings, market news, and the companies and limits in Config.Borsa.

Stock Bulletin (borsa) is a stock market page. The server makes every price; players buy and sell shares of the companies you list. Settings are in apps/borsa/config.lua (Config.Borsa).

#What the player can do

  • Read the bulletin: each company with its sector, a small chart, the price and the day's change.
  • Open a company page with a larger chart (day, week, month), its description, home town and dividend.
  • Buy and sell shares in a sheet that shows the total before confirming. If the price moved while the sheet was open, the trade is refused and the new price is shown.
  • See their holdings and their trades.
  • Read the market news: your own headlines, plus short automatic notes when a share moves more than News.BigMove percent in a day.

Prices move every TickMinutes on the server. The server keeps one point per hour for 30 days and continues from the last price after a restart. On first start it fills a month of history so the charts are not empty. Dividends are shown only; nothing is paid.

#What it needs

Need Notes
Money Buying takes money from, and selling pays into, the account in Config.MoneyAccount (cash by default)
Signal Only when RequireSignal = true, and only for trading. Reading prices is always open

#Settings

Key Default What it does
Enabled true Turns the app on
RequireSignal false Trading needs a signal
City / Year 'Saint Denis' / 1899 City and year in the bulletin's heading. Day and month are the real calendar
TickMinutes 5 How often prices move (at least 1)
Commission 1.0 Percent taken on every buy and sell. 0: none
MaxPerTrade 100 Shares in one buy
MaxSharesPerCompany 500 Shares one player can hold in one company. 0: no limit
TradeCooldown 2 Seconds between two trades
MinFactor / MaxFactor 0.35 / 3.0 A price stays between these multiples of its start price
MaxMovePerTick 3.0 Largest move in one step, in percent
Revert 0.0003 Pull towards the start price each step. 0: none
Companies eight companies See below
News.Enabled true The news tab
News.BigMove 4.0 Percent move in a day that writes an automatic note. 0: off
News.Headlines six headlines Your own news items

#Companies

lua{ id = 'SDD', name = 'Saint Denis Demiryolu', sector = 'Demiryolu', icon = 'train', color = 'blue',
  price = 48.25, volatility = 0.012, drift = 0.5, hq = 'Saint Denis', dividend = 1.2,
  text = 'Lemoyne ile New Hanover arasinda yolcu ve yuk tasir.' },
Field What it is
id 2 to 6 capital letters. Never change it later: players' shares are tied to it
name, sector, hq, text Texts shown on the page
icon A file name in preview/assets/mdi/ without .svg
color blue, green, red, ochre, plum or teal
price Start price in dollars
volatility How much it moves: 0.005 calm, 0.03 very lively
drift Tendency: -1 falling, 0 neutral, 1 rising
dividend Shown only, never paid

Do not delete a company while players hold its shares: those shares could no longer be sold.

A headline:

lua{ company = 'SDD', img = 'train', hours = 2, title = 'Annesburg hattina ikinci ray doseniyor',
  sum = 'Short summary.', body = 'Full text.' },

img is optional: train, mine, cattle, theatre, fair, sheriff, fishing or caravan. hours is the age shown ("2 hours ago"). The first headline is shown large.