# Game Settings

Game settings control who can access your game, when they can play, and how the experience works.

**To access:** Navigate to your classroom → Click the game → Select **Settings** tab

***

## Basic Information

**Game Name** - What participants see. Change this anytime.

**Description** - Optional context shown before they start playing. Use it to explain the scenario or provide instructions.

**Status:**

* **Active** - Participants can access the game
* **Inactive** - Hidden but data preserved
* **Archived** - Read-only, no new participants

***

## Who Can Join

### Auto-Assign

Controls whether classroom members automatically get enrolled in this game.

**ON** - Anyone who joins your classroom automatically gets access to this game. Use for open enrollment or when everyone in the classroom should play.

**OFF** - You manually choose who gets access. Use for selective access or when the game isn't ready yet.

See [Auto-Assign documentation](/using-the-tenant-system/analytics.md#auto-assign-feature) for detailed workflows.

### Join Link

Every game gets a unique URL. Share this link and participants can access the game directly - even if they're not in your classroom.

**Security note:** Anyone with the link can access your game unless you add password protection. Don't post links publicly.

**Regenerate the link** if it's been shared too widely or you want to invalidate old distributions. Current participants stay enrolled; they just can't use the old link.

### Password Protection

Add a password requirement to the join link. Participants need both the link AND the password to get in.

* Set a custom password you'll announce at your event, or
* Generate a secure random password for better security

Change the password anytime. Participants will need the new password on their next access.

### Participant Limits

**Maximum Participants** - Set a cap on enrollments. Once you hit this number, no one else can join (auto-assign stops, manual assignments fail, join link shows "full").

Use this for:

* Physical events with space constraints
* Licensed content with seat limits
* Competitions designed for a specific group size

**Waitlist** - Enable this to automatically queue people when the game fills up. If someone drops or you increase the limit, waitlisted participants get promoted automatically in the order they joined.

***

## When It's Available

### Start Date/Time

Game becomes accessible at this time. Before then, enrolled participants can see it but can't start playing.

**Use for:**

* Workshop that begins at a specific time
* Coordinating across time zones
* Releasing modules on a schedule (Week 1, Week 2, etc.)

Leave blank for immediate access when you create the game.

### End Date/Time

Submission deadline. After this, participants can still view the game and their answers, but they can't submit new answers or change existing ones.

**Use for:**

* Graded assessments with a deadline
* Competitions where everyone gets the same time window
* Course assignments tied to semester dates

Leave blank if you want the game open indefinitely.

### Time Limits

Add countdown timers during gameplay.

**Per-question limits** - Countdown on each question. Auto-submits when time runs out. Creates urgency and tests quick decision-making.

**Total game time limit** - Countdown for the entire game. Must finish all questions before the timer expires. Tests time management and prioritization.

Use time limits for competitive events or simulations of high-pressure scenarios. Skip them for learning environments where you want thoughtful analysis.

***

## Scoring & Leaderboards

### Leaderboard Visibility

* **Public** - Everyone sees the full leaderboard with names and scores
* **Anonymous** - Everyone sees rankings but not who's who
* **Private** - Participants see only their own rank
* **Disabled** - No leaderboard at all

**Refresh Rate** - How often the leaderboard updates. Real-time for competitive events, periodic (30s - 1min) for better performance, or manual refresh only.

### Point System

**Standard scoring** - Points per correct answer, with optional bonuses for speed or penalties for wrong attempts.

**Custom scoring** - Adjust point values per question to weight certain questions higher based on difficulty or importance.

### Team Mode

Enable team-based competition. Teams can self-organize or you can pre-assign them. Set team size limits if needed.

***

## Learning Experience

### Hints

**Enable/disable hints** - Built-in hints available for each question.

**Hint timing** - Immediate access, delayed (available after X seconds), or staged (reveal progressively).

**Hint penalty** - Optionally deduct points when participants use hints.

### Answer Feedback

* **Immediate** - Shows correct/incorrect right after submission
* **Delayed** - Reveals answers after the game ends
* **Partial credit** - Award points for incomplete but partially correct answers

### Retry Policy

* **Unlimited attempts** - Default; participants can try as many times as they want
* **Limited attempts** - Set maximum tries per question
* **Lockout** - Lock question after X failed attempts

***

## Quick Setup Guides

Choose a configuration based on your event type:

**Beginner Workshop**

* No time limits
* Hints enabled, no penalty
* Unlimited retries
* Public leaderboard for motivation

**Graded Assessment**

* Set end time (deadline)
* One attempt per question
* Delayed feedback (reveals after deadline)
* Private scoring

**Competition**

* Time limits enabled
* Hints disabled or penalized
* Limited retries
* Live public leaderboard

**Self-Paced Practice**

* No time limits or deadlines
* Hints available
* Unlimited retries
* Auto-assign ON for easy access

***

## Common Issues

**Participants can't access the game**

* Check game Status is Active
* Verify start date has passed (if set)
* Confirm auto-assign is ON or they're manually assigned
* Check join link and password are correct

**Auto-assign isn't working**

* Toggle must be ON
* Participants must be classroom members
* Game must be Active
* Check you haven't hit the participant limit

**Settings aren't saving**

* Click Save before leaving the page
* Verify you're a Classroom Manager or Tenant Manager
* Clear cache and refresh if settings look outdated

***

## Running a Game Smoothly

**Before sharing the game:**

* Configure all settings first
* Test with your own account
* Document your configuration for future events

**During the game:**

* Avoid changing core settings mid-game
* If you must change something, tell participants immediately

**After the game:**

* Export data before making major changes
* Archive or disable completed games
* Review what worked for next time

***

## Related Pages

* [Managing Games](/using-the-tenant-system/managing-games.md) - Creating and organizing games
* [Analytics](/using-the-tenant-system/analytics.md) - Understanding auto-assign and performance tracking
* [Managing Users](/using-the-tenant-system/managing-users.md) - Participant enrollment

***

[Back to Tenant Overview](/using-the-tenant-system/overview.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kc7cyber.com/using-the-tenant-system/managing-games/game-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
