Skip to content

About

用桌遊讓更多人加入開源社群!

Topics

Resources

Contributing

Stars

36 stars

Watchers

4 watching

Forks

Latest commit

 

History

1,709 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

開源星手村 - Open StarTer Village

English version: README.en.md

我們鼓勵更多人參與開源社群,透過這款桌上遊戲,幫助初學者快速了解開源文化、專案協作,以及開源所帶來的好處。此遊戲(不論是實體版或線上版)都是開放的,任何人都可以自由使用。

遊戲概要

遊戲目標

透過遊戲,玩家將了解:

  • 開源文化的核心價值,包括開放定義和四大自由
  • 開源的優勢
  • 開源社群的組織和運作方式
  • 如何參與開源專案的協作
  • 世界以及台灣重要且有趣的開放原始碼、開放政府和開放資料專案

適用場合

  • 用於介紹和入門開源文化的活動,例如開源新手村、開源科技訓練營等
  • 開源社群的聚會
  • 日常娛樂

遊戲規格

  • 適用玩家人數: 2-4人
  • 遊戲時間: 約60分鐘

如何開始

開放遊戲租借

如果您有興趣租借遊戲,請寄信至 hi@ocf.tw 進行申請,同時請附上遊戲出借同意書。

開放遊戲伺服器

建置中!

如需自行部署網頁版遊戲,請參考 Deploy Your Own Village。

如何參與

我們歡迎各種形式的貢獻,即使您不具備程式能力,也歡迎分享您的想法。此專案有實體和線上兩個版本,您可以在我們的維基頁面上查看所有專案的規劃和進度,任何有 "[Assistance Required]" 標記的項目都歡迎您加入貢獻。

發現問題?解決問題?

如果您有 GitHub 帳戶,歡迎在我們的 Issues 頁面上回報問題或提出建議。 如果您沒有 GitHub 帳戶,也歡迎透過我們的 Discord 與我們討論。

想要增加新功能?

如果您有 GitHub 帳戶,歡迎在我們的 Discussions 中提出您的建議,或直接透過 Pull Requests 提供您的解決方案。

加入討論

您可以透過我們的 Discord 加入我們的討論。

線上專案架構

子專案 說明
google-spreadsheet 原型版本 - 以 Google Spreadsheet 呈現
packages/webapp 網頁版遊戲 - 處理遊戲規則
homepage 官方網站 - Official Website

開發環境與專案結構

此 repository 使用 pnpm 11.15.1 monorepo workspace 統一管理 webapp 與 homepage:

  • packages/webapp/:主要線上遊戲,包含 Next.js client 與 boardgame.io 遊戲伺服器。
  • homepage/:官方網站,獨立部署於 Netlify,使用 Next.js 與 Decap CMS。
  • google-spreadsheet/:早期 Google Apps Script 原型,僅作為參考。

基本需求:

  • Node.js >= 24。
  • 使用 repository 指定的 pnpm 版本,不需另行安裝全域 pnpm。
  • 從 repository 根目錄執行 pnpm install --frozen-lockfile 安裝所有 workspace 套件。

根目錄 workspace 常用指令:

pnpm all:dev      # 啟動所有 pnpm workspace 的開發伺服器
pnpm all:build    # 建置所有 pnpm workspace
pnpm all:lint     # 檢查所有 pnpm workspace

all:dev 使用 webapp 的 3000/3001 port,homepage 使用 3100 port。

Webapp 與 homepage 的細節請參考:

Commit Convention

Commit 訊息採用 Conventional Commits:

<type>(<optional scope>): <short description>
  • Type 可使用:feat, fix, docs, refactor, test, chore, style, perf。
  • Subject line 保持在 72 字元以內。
  • 使用祈使語氣,例如 add 而不是 added。
  • 每次 commit 只包含一個小範圍的變更,不要把無關變更包在同一個 commit。
  • 除非變更不易理解,否則不需要 commit body。

授權條款

進一步了解

您可以在我們的 Wiki 頁面 深入了解此專案。

其他相關連結:

About

用桌遊讓更多人加入開源社群!

Topics

Resources

Contributing

Stars

36 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

⌂