📖 Teacher Guide

Sign in → class → subject → share. First-time setup takes about 10 minutes.

NexoQuiz is a game where your students answer your quiz questions to beat monsters and earn points. You make the questions (the AI helps); they play on any phone or computer.

🚀 Getting Started

Before you begin (read once)

  • •You need a school Google account — the same one you use for DELIMa.
  • •Use a laptop or desktop for setup (a phone works, but the screen is small).
  • •Use the Google Chrome browser if you can.
⚠️ Teacher access (one time): an admin must turn on “teacher” for your account. Until then, after you sign in and choose HOST GAME you'll see an “awaiting teacher access” screen instead of the dashboard. If that happens, message your NexoQuiz admin, then sign in again once they've enabled it. (Before you sign in, HOST GAME is visible to everyone — that's normal.)

Step 1 — Open NexoQuiz

  1. 1Open Chrome.
  2. 2Type the NexoQuiz web address in the top bar and press Enter.
    Example screen
    https://nexo… ⏎ Enter
  3. 3You'll see a big NEXOQUIZ title. Click the green [ ENTER_SYSTEM ] button (or press Enter).
    Example screen
    NEXOQUIZ
    Knowledge_is_Power
    [ ENTER_SYSTEM ]

Step 2 — Sign in as a teacher

  1. 1You now see three big buttons: JOIN GAME, MY CLASSES, HOST GAME.
    Example screen
    ⚔️
    JOIN GAME
    📚
    MY CLASSES
    📡
    HOST GAME
    Teacher
  2. 2Click the blue HOST GAME (it says Teacher underneath).
  3. 3A Google box appears. Click Continue with Google.
    Example screen
    Sign in
    G Continue with Google
    choose your school account
  4. 4Choose your school Google account. If asked, click Allow / Continue.
  5. 5You arrive at the 📡 Teacher Dashboard.

    💡 Sent back to the menu with no HOST GAME? Your account isn't a teacher yet — see “Before you begin”.

    Example screen
    ← Home📡 Teacher Dashboard
    + Create class🛠️ Build a subject
    No active classes yet

Step 3 — Your dashboard, in 10 seconds

  • •+ Create class (green) — make a new class.
  • •Top-right round icon — your Google account; click it to sign out.
  • •🏫 (school name) — the school your classes file under (set by admin).
Example screen
← Home❓ Guide
the ❓ Guide link opens this page

Step 4 — Create your first class

  1. 1Click + Create class.
  2. 2Type a class name, e.g. 5 Biru.
    Example screen
    📚 New class
    Class name
    5 Biru
    Create class
  3. 3Click Create class.
  4. 4A class card appears with a green code (6 letters/numbers, e.g. AB12CD). This is the CO-TEACHER code — another teacher enters it to co-teach your class. Students never use it: they join automatically when they open your Google Classroom assignment.
    Example screen
    5 Biru📋 AB12CDManage
    0 students · 0 subjects
    + New subject

Step 5 — Add a subject to the class

A subject is one playable game (e.g. Biology) inside a class.

  1. 1On the class card, click + New subject.
  2. 2Type a subject name, e.g. Biology.
    Example screen
    🌍 New subject
    Subject for 5 Biru
    Biology
    Create & add questions
  3. 3Click Create & add questions. This opens the Question Builder for you.
    Example screen
    🛠️ Question Builder · Biology
    Topic
    Type a topic…Generate

Step 6 — Add questions (the AI writes them)

  1. 1Find the Topic box.
  2. 2Type what the questions are about, e.g. Photosynthesis.
    Example screen
    Topic
    PhotosynthesisGenerate
  3. 3Click GENERATE. The AI writes 10 questions — wait a few seconds.
    Example screen
    10 questions generated
    1. What gas do plants take in?
    2. Where does it happen?
    3. What is the green pigment?
    …and 7 more
  4. 4Read them. To fix one, click it and edit (or delete a weak one).
  5. 5Click 💾 Save to subject. Each question becomes a monster on the map.
    Example screen
    💾 Save to subject
    each question becomes a monster on the map
  6. 6Click ← Back to return to the dashboard.

Step 7 — Start the subject (play it live)

  1. 1On the subject row, find the green ▶ Start button.

    💡 If ▶ Start is grey, the subject has no questions yet — go back to Step 6.

    Example screen
    🌍Biology10 questions · code AB12CD▶ Start📝 Questions⋯
  2. 2Click ▶ Start. You enter the game as the host, and a 6-character code is created for this subject.
  3. 3To stop, just leave the page. You can press ▶ Start again anytime.
🎉 Done! Signed in → made a class → added a subject → added questions → started the subject. Next: share it with your students.

📤 Sharing with Students

First, the two kinds of invite

They are different — you can use either or both:

Co-teacher codePlay link / QR
What it doesAnother teacher co-teaches your classStudent opens one game now
Who uses itTeachers only — students are refusedStudents, from Google Classroom
Best forSharing marking & analyticsLessons and homework
Where you find itClass card / class pageA subject's ⋯ menu
✅ Good to know: the first time a student opens your assignment link, NexoQuiz shows them a one-tap card — “Join this class?” — before they play. That's how they get onto your roster: no class code, no typing. A student who is already in another class is stopped and asked to sign in with their own DELIMa account (this protects brothers and sisters sharing one phone).
⚠️ Before you can Copy a link or show a QR, the subject needs a code. Press ▶ Start once (Step 7) — or use Share to Classroom below, which makes the code for you. If Copy play link / Show QR code look grey, that's why. Whenever a button is grey, the subject's card tells you why in the line just under it.

Method 1 — Google Classroom (best for DELIMa schools)

  1. 1Find the subject on your Dashboard. At the bottom of its card is one button that sends it to students.
    Example screen
    Biology settings
    📚Share to Classroom
    📋Copy play link
    📷Show QR code
    ✏️Rename subject
  2. 2Click 📚 Share to Classroom. (If it says ✨ Publish new version instead, you have new questions waiting — see “Every week” below.)
  3. 3A Google window opens. Choose the class and post it as an assignment.
    Example screen
    📚 Google Classroom
    Share to a class
    ▾ 5 Biru — Biology
    Assign
  4. 4Done. Students click the assignment to play, and the link keeps working even when you're offline.

    💡 Nothing opened? Your browser blocked the pop-up — click the pop-up icon in the address bar, choose Allow, and click Share to Classroom again.

Example screen
https://nexo…🚫
Pop-up blocked · Allow

Method 2 — Share a link

  1. 1Click the subject's ⋯ menu → 📋 Copy play link. (Greyed out? See the warning above.)
  2. 2Paste the link into WhatsApp, Telegram, Google Chat, or email.
    Example screen
    Play here 👇
    https://nexo…/join?code=AB12CD
  3. 3Students tap the link — many will auto-continue into the game after a short 3-2-1 countdown.
ℹ️ Joining the class happens through the play link itself: the first time a student opens it, they confirm “Join this class?” once and they're on your roster. The class card's 📋 code button is for inviting a CO-TEACHER, not students.

Method 3 — QR code (in class or in a chat group)

Open the QR once, then either show it live or send it.

  1. 1Click the subject's ⋯ menu → 📷 Show QR code. A big QR fills the screen.
    Example screen
    Scan to play · Biology
    AB12CD
    ⬇ Download imageClose
  2. 2Live in class: show it on the projector / TV — students point their phone camera at it and tap the link.

Or send the QR to a WhatsApp group

  1. 1In the QR pop-up, click ⬇ Download image. This saves a picture that has the QR, the class and the subject.
  2. 2Send that picture to your WhatsApp group (or any chat).
    Example screen
    Play here 👇
    https://nexo…/join?code=AB12CD
  3. 3When a student opens it and scans the QR, they're added to the class and the subject opens straight away.
✅ A QR is scanned from another screen or a printout. If a student only has the one phone, also send them the play link (Method 2) — tapping it opens the game directly.
ℹ️ The class page also shows a QR for joining the whole class at once.

Post once; students return through Google Classroom

Post the subject link to Google Classroom once. A verified DELIMa student gets three hours of NexoQuiz access after opening that assignment. When the access period ends, the student reopens the same Classroom assignment; the teacher does not need to publish a new link. XP, Astra and ranking are always kept.

✅ The in-game Classes button opens Classes → Subjects. During the same three-hour pass, eligible students can change between their own published subjects without another Classroom trip. Teachers can enter only classes they teach. School Admins and the Project Owner may browse authorized live totals; they can enter only where they are also an assigned class teacher.
  1. 1Use Share to Classroom and post the subject link to the class assignment.
  2. 2Students open that assignment with their DELIMa account. The link grants three hours of NexoQuiz play.
  3. 3After three hours, NexoQuiz asks the student to reopen Google Classroom. They use the same assignment link, so there is no republishing work for the teacher.
  4. 4Use ✨ Publish new version only after changing the subject's questions. Then post the fresh link; old links send students back to Classroom. Their progress is never lost.
✅ Just trying it out? The Guest choice (Main sebagai Tetamu) on the join page starts a game right away with no login — but nothing is saved (no XP, Astra or ranking). It's for a quick one-off try; for real class work, students sign in with their DELIMa (Google) account.
ℹ️ This only affects students. You (the teacher) are never sent to Classroom by a link — you can preview any subject anytime, and you stay signed in.
✅ For DELIMa activity, use Share to Classroom. Copy-link and QR remain useful for teacher previews, live sessions or controlled guest access, but signed-in anytime-play students are directed back to the Classroom assignment.

What your students see

  1. 1They land on a ⚔️ JOIN A GAME page with the code already filled in.
    Example screen
    ⚔️ JOIN A GAME
    AB12CD
    G Sign in with Google
    or play as Guest
    Start playing
  2. 2They either Sign in with Google (best — results saved under their real name) or type their name as a Guest, then tap Start playing / Play as guest.

    💡 If the school blocks student Google sign-in, Guest still works — the lesson is never blocked.

Checking their results

  1. 1Open the class → 📊 Analytics (whole class), or a subject → 📊 Stats (one subject).
    Example screen
    📊 Analytics⬇ Export CSV
  2. 2Click ⬇ Export CSV to open the marks in Excel / Google Sheets.

🆘 Quick Help

❓ I see “awaiting teacher access” (or no HOST GAME).
→ Your account isn't a teacher yet — contact your admin, then sign in again once they've enabled it.
❓ ▶ Start is grey.
→ The subject has no questions — add some (Getting Started, Step 6).
❓ Copy play link / Show QR is grey.
→ Press ▶ Start once first, or use Share to Classroom (it makes the link).
❓ Google Classroom didn't open.
→ Tap the button again after checking the internet connection. If a new tab is blocked, NexoQuiz falls back to opening Classroom in the same page; you can also open the Classroom app manually and choose the assignment.
❓ A student can't sign in with Google.
→ Use Guest — type the name and play.
❓ My student sees “New content is out — open Google Classroom”.
→ Their link is from an older version. They tap Buka Google Classroom, open your class and tap the latest NexoQuiz link — straight in. Their progress (XP, Astra, ranking) is safe; only the link changed. Make sure you've posted the fresh link after tapping Publish new version — while it is still waiting, the subject's card says “New questions aren't live yet”.
❓ Wrong school shown.
→ Your admin sets this — ask them to change it.