=== Charades Game ===
Contributors: mixaliskappas
Tags: charades, party game, fun, pantomime, team game
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your site into a fun, mobile-friendly charades game! Custom words, teams, timer, scoring — great for parties or classrooms.

== Description ==

Bring the classic **Charades** (Pantomime) game to your WordPress website. Whether you're at a party, in a classroom, or just bored at home — this plugin transforms your browser into an interactive and engaging **team-based word guessing game**!

🎭 **Features:**

- Create custom categories with optional icons (recommended size: 64x64 px)
- Add your own words or phrases per category
- Include an optional comment or hint for each word (e.g., author, year, clue)
- Two-team rotation system for turn-based gameplay
- Built-in timer and automatic scoring system
- Tie-breaker logic using average team response times
- Wake Lock enabled to prevent screen sleep during play
- **Fully responsive and mobile-friendly** – play on any device!
- No logins, no third-party accounts required

🧩 Perfect for:
- Family gatherings & parties  
- Classroom activities & educational games  
- Remote team-building sessions  
- Ice-breakers and social events  

== How It Works ==

1. The admin creates categories (e.g., "Books", "Movies", "Animals") and uploads a 64x64px icon.
2. Each category contains words/phrases and optionally a short comment (e.g., *"The Girl with the Dragon Tattoo"* – Author: Larsson Stieg).
3. Players split into **two teams** and choose team names.
4. A random word or phrase is shown to one team while the others guess.
5. Each team has a set time (default: 90 seconds) to act out and guess the word.
6. Teams alternate turns; correct guesses earn points.
7. The team with the most points (or the fastest response time in a tie) wins!

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/charades-game` directory, or install it via the WordPress Plugin Repository.
2. Activate the plugin from the "Plugins" menu in WordPress.
3. Navigate to **Charades Game** in the WordPress dashboard to start adding your custom content.
4. Create a page or post and use the shortcode below to embed the game interface.

== Shortcode ==

To add the game to any page or post, use:  
`[charades_game]`

== FAQ ==

= Is this plugin mobile friendly? =  
Absolutely. The game is fully responsive and works smoothly on smartphones, tablets, and desktops.

= Can I use my own words and categories? =  
Yes! You can fully customize the game content to suit your audience or event.

= Can more than two teams play? =  
Currently, the game is designed for two alternating teams. Future updates may include more options.

= Are repeated words avoided? =  
Yes. Words are automatically tracked and excluded from immediate repetition.

= Will the screen stay awake during gameplay? =  
Yes. The plugin uses the Wake Lock API to prevent sleep mode. Note: Some mobile browsers (e.g., iOS Safari) may have limited support.

= Do I need an internet connection to play? =  
Only to load the game page. All gameplay runs entirely in-browser.

= Can I support development? =  
Sure! Crypto donations are welcome – see below for wallet addresses.

== Screenshots ==

1. **Category creation** – Add custom categories and upload icons in the admin panel.
2. **Words & Comments section** – Define words or phrases and optional comments per category.
3. **Game Texts editor** – Customize all game interface text (translate or rephrase as needed).
4. **Start screen** – Launches the game setup flow.
5. **Team name input** – Enter names for both teams before playing.
6. **Category selection** – Choose a category before each round.
7. **Team turn indicator** – Shows which team is currently playing.
8. **Gameplay screen** – View the word/phrase, comment, and countdown timer.
9. **Game results** – Displays the final score and winning team.

== Donations ==

If you enjoy the plugin and want to support future development:

- **ETH**: 0x34Fd81CEb2F32520327c317b9F517B4A4EdAcE87  
- **BTC**: 12XMSJNTLMSJjXrorzrnqNT5j79zH1jFsX  
- **BNB**: 0x581605a14da425532646572fcfa0e9a46fdaa294  

Your support helps keep this free and fun! 🎉

== Changelog ==

= 1.0.0 =  
* Initial release – full gameplay, custom categories, scoring, wake lock, and responsive mobile support.

== Upgrade Notice ==

= 1.0.0 =  
First official version. Stable and ready to play!