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.BigMovepercent 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.