Skip to content

A word-building game that helps students enhance their language skills by creating meaningful words for points

Notifications You must be signed in to change notification settings

EkerVitorSob/word-world

Repository files navigation

Word World

Word World is a competitive, two-player game designed for the Eker Vitor Sob platform. It challenges players to build meaningful words on a 2D grid, enhancing their vocabulary, spelling, and strategic thinking. This game is perfect for students from toddlers to higher grade levels, making learning fun and engaging through friendly competition.

Table of Contents

Overview

Word World is a turn-based battle where classmates compete by placing letters on a grid to form words. The goal is to create the longest, most valuable words to score points. Each letter placed on the grid has the potential to contribute to a word in multiple directions, which adds a layer of strategy to the game. No global players—just classmates competing for the highest score!

Gameplay

  • The game begins on a blank 2D grid.
  • Players take turns placing letters on the grid, with the objective of forming words.
  • Words can be created horizontally or vertically.
  • When a player successfully forms a word, they score points equivalent to the length of the word.
  • The game continues until the grid is full or both players can no longer form words.
  • The player with the highest score wins.

Example

  1. Player 1 places the letter "C" in row 2, column 3.
  2. Player 2 places the letter "A" in row 2, column 4.
  3. Player 1 places the letter "T" in row 2, column 5, forming the word "CAT" and scoring 3 points.

Features

  • Turn-Based Play: Players alternate turns, encouraging strategic planning and decision-making.
  • Classroom-Exclusive Battles: Players can only challenge their classmates, fostering a sense of community and friendly rivalry.
  • Real-Time Scoring: Points are calculated immediately when a word is formed, with a live scoreboard.
  • Word Validation: Built-in dictionary validation ensures only meaningful words are scored.
  • Multiple Word Directions: Words can be created both vertically and horizontally.
  • Endless Replayability: Each battle brings a unique challenge with new grid layouts and letter placements.

Technologies Used

  • Frontend: React.js, HTML5, CSS3, JavaScript
  • Backend: Node.js, Express
  • Game Engine: Phaser.js for 2D grid rendering and gameplay mechanics
  • Dictionary API: Used for validating word entries and scoring

Installation

To set up Word World locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/eker-vitor-sob/word-world.git
  2. Navigate into the project directory:

    cd word-world
  3. Install the required dependencies:

    npm install
  4. Run the application:

    npm start

Usage

Once the game is running, two players can:

  • Take turns to place letters on the grid.
  • View their progress and score in real-time.
  • Challenge classmates and track their performance over multiple games.

Demo

A live demo will be available soon at Live Demo Link.

Contributing

We welcome contributions to Word World! Here's how you can contribute:

  1. Fork the repository.
  2. Create a new branch:
    git checkout -b feature/your-feature
  3. Commit your changes:
    git commit -m 'Add your feature'
  4. Push the changes to your branch:
    git push origin feature/your-feature
  5. Open a pull request for review.

Check the Contributing Guidelines for more details.

License

This project is licensed under the MIT License. See the LICENSE file for more information.

Contact

For any questions or suggestions, feel free to reach out to us:

About

A word-building game that helps students enhance their language skills by creating meaningful words for points

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages