martinmol2007/dice-sim

This is a command-line program written in C++ that simulates rolling a six-sided die any number of times and saves the results to text files. You specify how many rolls to run and choose between two output modes. Normal mode records each individual roll in a history file with an ASCII art drawing of the die face for that result. Each face is drawn using box-drawing characters to look like a physical die on screen. Fast mode skips the per-roll drawings and only tracks the running totals, which makes it suitable for running millions of rolls quickly without generating very large output files. After all rolls are done, both modes produce a statistics file. This file shows a text-based bar chart with one row per die face, pipe characters representing the frequency, and the percentage for each value from 1 to 6. The simulation's total runtime in milliseconds is reported at the bottom. Each run writes to new files named with the current Unix timestamp, so earlier results are never overwritten. Building the program requires a C++17 compiler, with g++ recommended. The included Makefile provides two commands: make program compiles everything and creates the output folder, and make clean deletes previously generated files. The compiled executable then prompts for the number of rolls and the chosen mode before starting. The repository notes that a Spanish language version of the project exists in a separate linked repository.