Getting Started with 2D Games Using Arcade Library (Part 11): Switching Between Screens

Source: Dev.to

Organize Files

As development continues, the number of source files increases and management becomes more difficult.
Create a dedicated src folder for source code and split the screens into three modules, one per screen.

The folder structure will look like this:

# Folder structure
working_directory/
├─ main.py
├─ images/
└─ src/            # Folder for source code
   ├─ title.py
   ├─ game.py
   └─ result.py

Switch Screens

The code for switching screens is the same as in previous examples.
At any point where a screen transition is needed, simply:

1. Create an arcade.View.
2. Pass it to window.show_view().

# main.py (example)

view = title.TitleView(window)  # TitleView
window.show_view(view)

Complete Code

Below is a complete working example. Press the SPACE key to switch screens in this order:

Title Screen → Game Screen → Result Screen

You can copy and run the code as‑is.

main.py

import arcade
import src.title as title

def main():
    """Main process"""
    window = arcade.Window(480, 320, "Hello, Arcade!!")
    view = title.TitleView(window)  # TitleView
    window.show_view(view)
    arcade.run()

if __name__ == "__main__":
    main()

src/title.py

import arcade
import src.game as game

# Title screen
class TitleView(arcade.View):
    def __init__(self, window):
        super().__init__()
        self.window = window
        self.background_color = arcade.color.PRUNE

        # Info text
        self.msg_info = arcade.Text(
            "TITLE: SPACE TO NEXT",
            window.width / 2, window.height - 20,
            arcade.color.WHITE, 12,
            anchor_x="center", anchor_y="top"
        )

    def on_key_press(self, key, key_modifiers):
        # SPACE → Game screen
        if key == arcade.key.SPACE:
            view = game.GameView(self.window)  # GameView
            self.window.show_view(view)

    def on_update(self, delta_time):
        pass

    def on_draw(self):
        self.clear()
        self.msg_info.draw()

src/game.py

import arcade
import src.result as result

# Game screen
class GameView(arcade.View):
    def __init__(self, window):
        super().__init__()
        self.window = window
        self.background_color = arcade.color.DARK_SPRING_GREEN

        # Info text
        self.msg_info = arcade.Text(
            "GAME: SPACE TO NEXT",
            window.width / 2, window.height - 20,
            arcade.color.WHITE, 12,
            anchor_x="center", anchor_y="top"
        )

    def on_key_press(self, key, key_modifiers):
        # SPACE → Result screen
        if key == arcade.key.SPACE:
            view = result.ResultView(self.window)  # ResultView
            self.window.show_view(view)

    def on_update(self, delta_time):
        pass

    def on_draw(self):
        self.clear()
        self.msg_info.draw()

src/result.py

import arcade
import src.title as title

# Result screen
class ResultView(arcade.View):
    def __init__(self, window):
        super().__init__()
        self.window = window
        self.background_color = arcade.color.CERULEAN

        # Info text
        self.msg_info = arcade.Text(
            "RESULT: SPACE TO NEXT",
            window.width / 2, window.height - 20,
            arcade.color.WHITE, 12,
            anchor_x="center", anchor_y="top"
        )

    def on_key_press(self, key, key_modifiers):
        # SPACE → Title screen
        if key == arcade.key.SPACE:
            view = title.TitleView(self.window)  # TitleView
            self.window.show_view(view)

    def on_update(self, delta_time):
        pass

    def on_draw(self):
        self.clear()
        self.msg_info.draw()

The result will look like this:

Final Thoughts

Thank you very much for reading.
I hope this series becomes a starting point for your own game development journey. ޱ(ఠ皿ఠ)ว👍