@@ -10,6 +10,8 @@ Welcome to the **World Geography Challenge** — an interactive and educational
1010- 🤝 ** Open Source** : Encourage contribution, learning, and community development.
1111- 🔧 ** Extensible** : Easily add your own questions or difficulty levels.
1212- 🌐 ** Accessible** : All code, comments, and UI text are in English for global reach.
13+ - 🌍 ** Multilingual** : Supports English, Greek, and French for both UI and quiz content.
14+ - 🎵 ** Customizable Music** : Choose from built-in tracks or play your own music file.
1315
1416---
1517
@@ -20,23 +22,29 @@ Welcome to the **World Geography Challenge** — an interactive and educational
2022- 📈 ** Score Tracking** : Real-time updates to your score.
2123- 🏆 ** Leaderboard** : Compete with yourself or friends for high scores!
2224- 🎵 ** Background Music** : Choose from built-in tracks or add your own.
23- - ⚙️ ** Settings Menu** : Customize your experience.
25+ - ⚙️ ** Settings Menu** : Customize your experience, including language and music selection .
2426- 🧱 ** Modular Code** : Clean file structure for easy maintenance and contributions.
27+ - 🌐 ** Multilingual Support** : All quiz questions and UI elements are available in English, Greek, and French.
28+ - 🗂️ ** Settings & Data in JSON** : User preferences and leaderboard data are stored in JSON for easy editing and portability.
2529
2630---
2731
2832## 🗂️ Project Structure
2933
3034```
31- 📁 GeographyQuizApp/
32- ├── geograph_with_buttons_3.py # Main launcher
33- ├── easy.py, easy2.py ... easy10.py # Easy questions
34- ├── normal.py, ... normal10.py # Normal questions
35- ├── hard.py, ... hard10.py # Hard questions
36- ├── marks.py # Results screen & leaderboard
37- ├── settings.txt # Settings save
38- ├── data.json # Leaderboard data
39- ├── Project Overview.pdf # Full project documentation
35+ 📁 World Geography Challenge/
36+ ├── World_Geography_Challenge.py # Main launcher and UI logic
37+ ├── easy.py, easy2.py ... easy10.py # Easy questions (multilingual)
38+ ├── normal.py, ... normal10.py # Normal questions (multilingual)
39+ ├── hard.py, ... hard10.py # Hard questions (multilingual)
40+ ├── marks.py # Results screen & leaderboard
41+ ├── extra_files/
42+ │ ├── settings.json # Settings (music, language)
43+ │ ├── language.txt # Current language selection
44+ │ ├── *.mp3 # Built-in music tracks
45+ │ └── *.ico # App icon
46+ ├── data.json # Leaderboard data
47+ ├── Project Overview.pdf # Full project documentation
4048```
4149
4250---
@@ -63,7 +71,7 @@ You can always download the latest version of the application without needing to
6371
6472- [ Python 3.x] ( https://www.python.org/ )
6573- [ PyQt5] ( https://pypi.org/project/PyQt5/ ) → ` pip install PyQt5 `
66- - (Optional) [ python-vlc] ( https://pypi.org/project/python-vlc/ ) for background music → ` pip install python-vlc `
74+ - [ python-vlc] ( https://pypi.org/project/python-vlc/ ) for background music → ` pip install python-vlc `
6775
6876#### Run the Application
6977
@@ -81,7 +89,7 @@ python World_Geography_Challenge.py
8189## 🧪 Example Flow
8290
8391- Choose your difficulty (Easy / Normal / Hard)
84- - Answer the 10 multiple-choice questions
92+ - Answer the 10 multiple-choice questions (in your selected language)
8593- See your score, correct/wrong answers
8694- Check your position on the leaderboard
8795- Play again or switch levels 🎮
@@ -94,9 +102,9 @@ Contributions are welcome — and beginners are encouraged!
94102
95103### 🛠️ What You Can Do
96104
97- - Add new quiz questions or difficulty levels
105+ - Add new quiz questions or difficulty levels (in all supported languages)
98106- Improve UI/UX (themes, animations, layout)
99- - Translate to other languages
107+ - Translate to other languages (add to the translation dictionaries)
100108- Implement new game modes (e.g., timed mode, multiplayer)
101109- Add accessibility features (keyboard support, colorblind mode)
102110- Write unit tests for core logic
@@ -113,8 +121,8 @@ Contributions are welcome — and beginners are encouraged!
113121
114122## 🧰 Files That Store Data
115123
116- - ` settings.txt ` : Stores user preferences like music settings.
117- - ` skore .txt` : Keeps your most recent game score .
124+ - ` extra_files/ settings.json ` : Stores user preferences like music and language settings.
125+ - ` extra_files/language .txt` : Stores the currently selected language .
118126- ` data.json ` : Tracks and stores leaderboard information.
119127
120128---
0 commit comments