← Back to Resources

how to author a roleplay

How to Use the SCORP Authoring Guide

For Educators: A Step-by-Step Walkthrough

---

Before You Start

What You'll Need

  • 30-60 minutes of preparation time
  • A text editor (Word, Google Docs, or even Notepad—no coding required)
  • Optional: images or documents you want to include
  • Optional: the SCORP authoring template file

What You Don't Need

  • Programming knowledge
  • Technical background
  • Experience with SCORP (we'll guide you through it)

---

The Writing Process: 5 Steps

STEP 1: Write Your Basic Information (5 minutes)

This is like writing the cover of your syllabus. Answer these simple questions:

1. What are you calling this? Roleplay Name:

Peace Negotiation Summit

Make it clear and descriptive.

2. Who made it? Creating Organization:

International Relations Department

This gives you credit.

3. What's the one-liner? Roleplay Description:

In this simulation, diplomats from three fictional countries negotiate a trade agreement while managing domestic political pressures. Think of it like a Netflix description—short enough to read in 5 seconds.

That's it for Step 1. Leave the other fields with defaults for now.

---

STEP 2: Describe What Students Will Learn (10 minutes)

Put yourself in a student's shoes: "What will I understand or be able to do after this roleplay that I couldn't before?"

Write 2-3 learning goals: Learning Objectives:
  • Students will understand how trade negotiations balance national interests with global commerce
  • Students will experience the challenge of representing a constituency with competing pressures
  • Students will practice diplomatic communication under time constraints
Who should take this? Expected Audience:
  • Upper-level undergraduate students
  • Prior knowledge of international trade policy helpful but not required
Tell them what to expect: Introduction:
  • This is a realistic simulation of international trade negotiations.
  • You will represent one country's interests.
  • You have 90 minutes to reach an agreement or declare negotiations failed.
  • Pay attention to both the official goals and the political pressures.
End with reflection questions: Debrief Questions:
  • What was the biggest challenge you faced as a negotiator?
  • How did you decide which issues to compromise on?
  • What surprised you about the other countries' perspectives?
  • What would you do differently if you ran this negotiation again?
Why this matters: These become the pages students see before and after the roleplay. Good ones help students get the most from the experience.

---

STEP 3: Define Your Timeline—Phases (10 minutes)

Think of a phase as a "chapter" in your simulation. Most roleplays have 2-4 phases.

Example timeline for trade negotiations:

Phase 1: Opening Statements

What happens:
  • Each country gets 10 minutes to present its opening position
  • The facilitator summarizes the key interests
  • This sets the tone for the rest of the negotiation

Phase 2: Bilateral Negotiations

What happens:
  • Countries pair off for direct negotiations
  • You have 30 minutes to find areas of agreement
  • Be willing to discuss strategic compromises

Phase 3: Final Agreement

What happens:
  • All countries meet together to finalize the agreement
  • You need everyone's approval to succeed
  • If you can't reach an agreement, the deal falls apart
Tips:
  • 2-3 minutes per phase is realistic
  • Each phase should have a clear purpose
  • Make descriptions concrete (time limits, activities)

---

STEP 4: Create Your Characters (15 minutes)

This is the heart of your roleplay. Each character should have a public face and secret pressures.

Example: Prime Minister of Eastland Character Name: Prime Minister of Eastland What Everyone Knows:
  • You lead Eastland, an agricultural economy that exports grains and dairy.
  • You're concerned about protecting farm jobs and prices.
What Your Allies Know:
  • Eastland's official position: We want 25% tariff protection on agricultural goods.
  • We're willing to discuss technology transfer in exchange.
What Only You Know (The Pressure):
  • Your country is in debt and NEEDS to increase exports by 20% this year.
  • If you fail, opposition parties will push you out of office.
  • You've been given secret authorization to go as low as 15% tariff if necessary.
  • You're most afraid of mass agricultural unemployment and rural collapse.
Key insight: The private description is what makes it real. That's the pressure cooker that creates interesting decisions. How many characters?
  • Minimum: 3 student roles + 1 facilitator = 4 total
  • Typical: 4-6 student roles + 1-2 facilitators = 5-8 total
  • Usually one per student, but you can clone roles

---

STEP 5: Map Out What Students Do—Activities (20 minutes)

For each phase, decide what activities students participate in. Use the checklist below.

Phase 1 activities might be:
  • Read background on their character (ShowDocument)
  • See all the other characters (Cast)
  • Read the rules and schedule (Introduction, Schedule)
  • Make an opening statement in chat (Chat)
Phase 2 activities might be:
  • Negotiation chat with one other actor (Chat)
  • Maybe a decision: "How much will you offer?" (Decision)
Phase 3 activities might be:
  • Final negotiation chat (Chat)
  • Answer debrief questions (DebriefQuestions)
Don't worry about the technical template format yet—we'll handle that part for you. For now, just plan what activities each phase should have. The Activity Options:

For each phase, you can include:

  • Introduction - Show the learning goals and what's about to happen
  • Schedule - Display the timeline and phase lengths
  • Cast - Let students see who else is involved
  • Background Info - Give each character their role description and context
  • Chat - Allow students to discuss and negotiate with others
  • Make a Decision - Have students choose between options
  • Reflection - Ask debrief questions at the end to help students process what they learned
Start simple. You don't need every option in every phase. Pick 2-3 activities per phase and you'll have a solid roleplay.

---

Common Scenarios: Copy and Paste These

Scenario 1: "Classroom Debate"

What students do:
  • Phase 1: Read background, see cast
  • Phase 2: Debate in chat
  • Phase 3: Vote and debrief
Activities:

``` Introduction → ShowDocument → Cast → Chat → Decision → DebriefQuestions ```

Scenario 2: "Small Group Negotiation"

What students do:
  • Phase 1: Get their character info
  • Phase 2: Pair off and negotiate privately
  • Phase 3: Group negotiation and agreement
  • Phase 4: Debrief
Activities:

``` Introduction → ShowDocument → PrivateChat → Chat → DebriefQuestions ```

Scenario 3: "Multi-Round Game"

What students do:
  • Each phase is one round
  • Round 1-3: Make decision → see results → get injected event
  • Final: Debrief reflection
Activities:

``` (per round) Decision → Inject → Announcement → (repeat) → DebriefQuestions ```

---

Writing Tips

For Character Descriptions

Public description = What everyone knows

``` ✗ "She's smart" ✓ "She's the Minister of Trade with 20 years of negotiation experience" ```

Private description = The conflict

``` ✗ "She wants to succeed" ✓ "She wants to succeed, but her government is threatening to replace her if she makes any concessions. She's desperate but trying not to show it." ```

For Phase Descriptions

Bad: "Negotiation phase" Good: "You have 30 minutes to negotiate directly with one other country. Find one area where you can reach agreement." Bad: "Wrapping up" Good: "Final 15 minutes. Try to lock in the agreements you've made and address any remaining sticking points."

For Learning Objectives

Bad: "Students will learn about trade" Good: "Students will understand how trade-offs between national interest and global cooperation shape policy"

---

When You're Ready to Submit

Before you send it in, check:
  • [ ] I've written learning objectives (what should students understand?)
  • [ ] I have 2-4 phases with clear descriptions
  • [ ] I've created at least 3 student roles with good private descriptions
  • [ ] I've planned activities for each phase
  • [ ] I've included debrief questions for reflection
To submit:

1. Save your roleplay as a text or Word document 2. Attach any images, documents, or background materials 3. Email to: [email@scsw.org] 4. Include your name, institution, and expected class size

What happens next:
  • We review it (1-2 days)
  • We discuss any questions or refinements
  • We convert it to our system
  • You test it with a small group (1-2 sessions)
  • We make final tweaks based on how it runs
  • It's ready for your full class!

---

What Happens Next

1. We review your roleplay (24-48 hours) 2. We convert it to the technical format (2-3 days) 3. You test it with a small group (1 week) 4. We refine it based on feedback (1-2 days) 5. It's live! You can use it with your full class

---

Example: A Complete Mini-Roleplay

Here's a tiny complete example to show you what the finished template looks like:

Roleplay Name: Classroom Budget Committee Roleplay Version: 0.0.1 Creating Organization: Community College Roleplay Description: You serve on your college's budget committee and must allocate limited funds among competing departments. Learning Objectives:
  • Understand budget trade-offs
  • Practice prioritization under constraints
  • See diverse stakeholder perspectives
Expected Audience:
  • Any students interested in governance and finance
Introduction:
  • You're serving on a committee that decides how to allocate $5M in budget cuts.
  • Each person represents a different department.
  • You have 45 minutes to decide.
Phases:
  • Opening Statements
  • Negotiation
  • Final Vote
Characters: Character 1: Biology Department Chair
  • What Only You Know: Biology is only $2M, but you need another $500K to keep the lab open. If you don't get it, you'll lose 3 faculty members.
Character 2: Business School Director
  • What Only You Know: Business brings in more tuition than any other program. You'll argue to protect enrollment.
Character 3: Library Director
  • What Only You Know: The library serves everyone. You'll argue for cutting specific services instead of deep departmental cuts.
Character 4: Provost (Facilitator)
  • What Everyone Knows: Your job is to keep the discussion fair and move toward a decision.
Activities:
  • Phase 1: Introduction → Show Document (here's the budget)
  • Phase 2: Chat (negotiate)
  • Phase 3: Decision (vote) → Reflection Questions

That's it. Simple, but effective.

---

Troubleshooting

Q: Do I need to write everything in this template?

A: No. Sections marked "Optional" can be skipped. At minimum: metadata, learning goals, phases, actors, and activities.

Q: How long should character descriptions be?

A: 2-3 sentences each. Students will read these in 1-2 minutes.

Q: How many actors should I create?

A: One per student, typically. If your class has 20 students and you want groups of 4, create 5 actors and have them clone to 4 students each.

Q: What if I want to change something after students start?

A: Tell your facilitator immediately. Small tweaks (like adding an Inject message) can be done on the fly. Major changes should wait for the next run.

Q: Is there a time limit to complete the template?

A: Spend as much time as you want, but you don't need to be perfect. 60 minutes of thinking + 30 minutes of writing is typical. You'll refine after testing.

---

Need Help?

Getting Started:
  • We have example roleplay templates available
  • Our team can answer questions about your design
After You're Done:
  • Contact us when you're ready to submit
  • We'll review your roleplay and help refine it
  • We handle converting your written guide into the technical format
  • You'll test it with a small group first before it goes live
Questions?
  • Email us at: [email@scsw.org]
  • We're happy to help with design questions before you submit

---

Good luck! We can't wait to see what you create.

SCORP Team Seachange Simulations Project August 2026