Тема: Trivia Mod

===================================================================
TriviaMod v2.3.0 — Advanced Trivia Script for PtokaX
===================================================================

Hi everyone,

I am releasing TriviaMod v2.3.0, a heavily improved version of the
classic Trivia script originally written by chill, then extended by
NRJ (Quiz 1.6). This release is the result of a long rework session
covering bugs, encoding, translation, and a set of new features.

-------------------------------------------------------------------
COMPATIBILITY
-------------------------------------------------------------------

- PtokaX 0.4.x.x / 0.5.x.x
- Lua 5.1 / 5.2 / 5.3 / 5.4
- Windows (Windows-1252 encoding)

-------------------------------------------------------------------
WHAT IS NEW COMPARED TO THE ORIGINAL v1.02d
-------------------------------------------------------------------

Core fixes
----------
* Fixed math.randomseed() crash on Lua 5.4 (os.clock() returns
a float — wrapped with math.floor())
* Fixed unclosed string in Commands.lu (ShowReport function,
line 382) that prevented the script from loading at all
* Fixed OnExit() crash when script failed to fully load
* Fixed questions.txt path (was pointing to wrong directory)
* Fixed duplicated line in !trivmytop stats display

Question file flexibility
-------------------------
* SplitLine() now auto-detects the number of separators per line:
- "{Cat} Question *Answer" (1 separator, no * after brace)
- "{Cat}*Question *Answer" (standard format)
- "{Cat} *Question *Answer" (extra space, also works)
All three formats are handled transparently, no config change
needed. Lines with only one separator no longer get silently
dropped when quesmode=1.
* GetQuestion() extracts the {Cat} category directly from the
question text when the Category field is empty.

Visual improvements
-------------------
* All question display modes (QuestionMode=1, showquestion 1/2/3)
now use the same framed layout as QuestionMode=0, with div1
separators for a consistent look across all modes.
* Correct answer, timeout reveal, and hints are all framed.
* Startup version printed to the PtokaX console.

New commands
------------
* !trivskip — skip current question (available to players)
* !trivconfskip — enable/disable skip (admin)
* !trivbreakskip — skip current break (admin)
* !trivgrades — show the full rank table with point thresholds

Rank system
-----------
* 10 configurable ranks (tRankMembers) with a fixed point interval
(RankInterval). Default ranks:
Novice / Apprentice / Curious / Scholar / Confirmed /
Expert / Quiz Master / Sage / Legend / Grand Champion
* Rank displayed in !trivscore (top list) and !trivmytop (stats).
* Automatic rank-up announcement when a player reaches a new rank.

Team mode (optional)
--------------------
* Activate by filling tCfg.Teams with nickname prefixes:
tCfg.Teams = { "[RED]", "[BLUE]", "[GREEN]" }
* Players are automatically assigned to a team based on their
nickname prefix — no login command required.
* Separate team score table (TeamScores.tbl), persisted to disk.
* !trivteamscore — show team ranking with rank badges.

Team multiplier — System C
--------------------------
* Players contribute to their team score with a multiplier based
on their personal rank tier:
Beginner (ranks 1-3) x1.0 — normal points
Intermediate (ranks 4-6) x1.5 — 50% bonus
Elite (ranks 7+) x2.0 — double points
* Multiplier announced after each correct answer.
* Team rank-up notified when the team crosses a new threshold.
* All coefficients are configurable in settings.lu (tTeamMulti).

-------------------------------------------------------------------
INSTALLATION
-------------------------------------------------------------------

1. Extract the ZIP into your PtokaX scripts folder.
2. The structure must be:

scripts/
Trivia_Mod.lua
TriviaMod/
settings.lu
questions.txt
Data/
Functions/

3. Edit TriviaMod/settings.lu to set your bot name, profiles,
command prefix, rank names, team prefixes, etc.
4. Load Trivia_Mod.lua from the PtokaX script manager.
5. Check the PtokaX console — you should see:
TriviaMod v2.3.0 loaded.

-------------------------------------------------------------------
QUESTION FILE FORMAT
-------------------------------------------------------------------

The script accepts three equivalent formats:

{Category} Question text *Answer
{Category}*Question text *Answer
{Category} *Question text *Answer

Multiple valid answers are separated by additional * characters:

{Category} *Question *Answer1 *Answer2

The category tag {…} is optional. Lines without it are read as
plain "Question *Answer" entries.

-------------------------------------------------------------------
COMMANDS SUMMARY
-------------------------------------------------------------------

Players
-------
!trivhelp — help
!trivmytop — your personal stats and rank
!trivscore — top scorers
!trivstats — top N player stats
!trivtoptime — top by average response time
!trivtopanswers — top by correct answer count
!trivtopstreak — top by streak
!trivskip — skip current question
!trivhint — request a hint
!trivreport — report an error in a question
!trivgrades — show rank table
!trivteamscore — show team ranking (if team mode active)
!login / !logout — join / leave the game (PM mode)

Admin
-----
!trivstart — start the quiz
!trivstop — stop the quiz
!trivpause — announce a break
!trivcontinue — resume after break
!trivbreakskip — skip current break
!trivquestion N — jump to question number N
!trivconfskip — toggle question skip on/off
!trivhint — toggle hints on/off
!trivchangemode — toggle sequential/random mode
!trivmain / !trivpm — switch main chat / PM mode
!trivaddquestion — add a question live
!trivshowreport — show error reports
!resetscores — reset all scores

-------------------------------------------------------------------
CREDITS
-------------------------------------------------------------------

Original script : chill
Quiz 1.6 rework : NRJ
v1.02d base : TriviaMod team
v2.x rework : Raphaël (FR)

Based on the original thread: http://mydc.ru/topic1377.html

-------------------------------------------------------------------
FEEDBACK
-------------------------------------------------------------------

Please report any bugs, suggestions or question file issues in
this thread. Tested on PtokaX 0.5.x with Lua 5.4 on Windows.