Chapter 0: About this book

Chapter 0: About this book

Purpose of this book

This book is for people who want to try making something interesting in Battlefield 6 Portal. It explains the basics of using the editor and the systems unique to Portal.
The goal is to become comfortable with Portal's scripting features and map editor, including programming practices that help you run a Portal server over the long term.
This book does not cover block-based visual programming. It focuses mainly on implementation with TypeScript.

About visual programming and map editors

For visual programming and map editor usage, "BF Portal BF6 notes by TOKAI_Server_JPN" provides a detailed explanation.

Target audience

In short, this book is aimed at readers who are still beginners at programming. More specifically, it assumes the following.

  • You have studied the very basics of programming (roughly the level taught in Japanese junior high schools as of 2025).
  • You have programmed in another language, but have not gone very deep with it.

In Japan's 2025 junior high school curriculum, this means roughly being able to understand how measurement and control systems work, and being able to create safe and appropriate programs.

Guide to the Use of ICT in Education - Supplementary Edition - (June 2020), Chapter 3 (Ministry of Education, Culture, Sports, Science and Technology): https://www.mext.go.jp/content/20200608-mxt_jogai01-000003284_004.pdf

Therefore, this book is not an introductory book for programming or learning grammar.
For TypeScript syntax, I recommend introductory resources such as "Survival TypeScript".
For learning how to use Godot, I recommend reading the "Godot Engine official docs".

Target audience for the appendix

  • People who can program as naturally as breathing.

The appendix is a handbook for people who can already program but are using Portal's TypeScript API for the first time.

Acknowledgments

This book was reviewed and revised with the help of the following people. I would like to take this opportunity to express my sincere gratitude.

Changelog

2026-04-30: First draft
2026-05-01: Added a chapter about the BF6 Portal TypeScript MCP server and the workflow for giving AI the situation and logs to build Portal code
2026-05-02: Added supplemental notes about MCP setup in Codex App, how to ask AI for help, and rate limits