An open API service indexing awesome lists of open source software.

https://github.com/ppo-gg/unfit-for-print

Unfit For Print - A Cards Against Humanity clone
https://github.com/ppo-gg/unfit-for-print

appwrite card-game game nuxt vue

Last synced: 4 months ago
JSON representation

Unfit For Print - A Cards Against Humanity clone

Awesome Lists containing this project

README

          


UNFIT FOR PRINT Logo

![Appwrite](https://img.shields.io/badge/Appwrite-%23FD366E.svg?style=flat&logo=appwrite&logoColor=white)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/PPO-GG/unfit-for-print/release.yml)
![GitHub License](https://img.shields.io/github/license/PPO-GG/unfit-for-print)
![GitHub package.json version (branch)](https://img.shields.io/github/package-json/v/PPO-GG/unfit-for-print/main)

# UNFIT FOR PRINT

## About the Game

**UNFIT FOR PRINT - A PARTY GAME FOR HIDEOUS PEOPLE**
is a Cards Against Humanity clone developed by **MYND** at **[PPO.GG](https://ppo.gg)**. It provides feature rich gameplay, Pretty (decent) visuals, and lots of features not found in any other Cards Against Humanity clones.

###### *We are not affiliated with Cards Against Humanity, we just love their game.*

---
## Screenshots


Unfit For Print Homepage Screenshot
Unfit For Print Game Screenshot
Unfit For Print Game Screenshot

---
## How to Play

### Game Setup

1. **Create or Join a Lobby**: Start by creating a new lobby or joining an existing one using a lobby code.
2. **Invite Friends**: Share your lobby code with friends so they can join your game.
3. **Configure Settings**: The host can customize game settings including:
- Maximum points to win
- Cards per player
- Card packs to include
- Privacy settings

### Gameplay

1. **Roles**: Each round, one player is designated as the "Judge" (rotates each round).
2. **Black Card**: The Judge reveals a black card with a prompt or fill-in-the-blank statement.
3. **White Cards**: Other players select one or more white cards from their hand to respond to the black card.
4. **Judging**: The Judge reviews all submissions (anonymously) and selects the funniest or most outrageous response.
5. **Scoring**: The player with the winning submission earns a point.
6. **New Round**: A new Judge is selected, and a new black card is drawn.
7. **Game End**: The first player to reach the point limit (default: 10 points) wins the game.

### Player Types

- **Participants**: Active players who submit cards and can win rounds
- **Spectators**: Observers who can watch the game but don't participate
- **Host**: The player who created the lobby and has special privileges

## Features

### Core Gameplay

- **Real-time Card Play**: Submit cards and see results instantly
- **Rotating Judge System**: Everyone gets a turn to be the Judge
- **Multiple Card Selection**: Some black cards require multiple white cards

### Social Features

- **Lobby System**: Create private or public game rooms
- **Chat System**: In-game chat to communicate with other players
- **Player Management**: Kick players or convert spectators to participants

### Customization

- **Game Settings**: Customize point limits, cards per player, and more
- **Card Packs**: Choose from different themed card packs
- **Player Profiles**: Customize your name and avatar

### Technical Features

- **Responsive Design**: Play on desktop or mobile devices (*work in progress, need to adjust layout a bit*)
- **Real-time Updates**: See game state changes instantly
- **Persistent Sessions**: Rejoin games if you get disconnected
- **Sound Effects**: Sound effects to enhance the gameplay experience (*work in progress, need to add more sounds*)

## Game Flow

1. **Lobby Phase**:
- Players join the lobby
- Host configures game settings
- Game starts when ready (minimum 3 players)

1. **Submission Phase**:
- Judge waits while other players select cards
- Players choose from their hand to respond to the black card

1. **Judging Phase**:
- All submissions are revealed (anonymously)
- Judge reviews and selects the winner
- Winning player and card are highlighted (*work in progress*)

1. **Round End**:
- Points are awarded
- Brief countdown to next round
- New Judge is selected

1. **Game End**:
- Final scores are displayed
- Winner is celebrated
- Players can return to lobby for another game

## Technical Implementation

UNFIT FOR PRINT is built using modern web technologies:

- **Frontend**: Nuxt 3 for a responsive and interactive UI
- **Backend**: Appwrite Server functions for game logic
- **Database**: Appwrite for real-time data storage and synchronization
- **Authentication**: Support for anonymous play and Discord login

## Community and Support

- **Report Issues**: Help improve the game by reporting bugs
- **Suggest Features**: Share your ideas for new features or card content
- **Join the Community**: Connect with other players on Discord

---

This game is still in development, expect features missing, gameplay bugs, and UI issues.