Entry Sync (엔트리 싱크)
엔트리(Entry) 작품을 위한 초저지연 실시간 동기화 & 영구 클라우드 저장 솔루션
핵심 특징 (Key Highlights)
4대 접두사 규칙 (Prefix Guide)
엔트리 만들기 화면에서 변수 또는 리스트를 생성할 때 원하는 기능에 맞춰 이름 앞에 접두사를 붙여주세요.
| 접두사 | 대상 | 동작 메커니즘 | 저장 위치 및 수명 | 활용 예시 |
|---|
| ?! | 연결 상태 변수(정확히 ?! 단독) | 작품 시작 시 기본값 0에서 연결 성공 시 1, 미연결 시 -1로 자동 전환 (블록 덮어쓰기 방지) | ❌ 저장 안 됨(일회성 연결 플래그) | [?!] = [1] 일 때 온라인 모드 시작 |
| !! | 실시간 동기화 전용(변수 및 리스트) | 동일 작품에 접속한 모든 플레이어 간 WebSocket 실시간 양방향 브로드캐스트 | 인원 0명 시 메모리 자동 파기(DB 저장 안 됨) | !!플레이어X, !!플레이어Y, !!채팅로그 |
| ?? | 데이터 영구 저장 전용(변수 및 리스트) | 작품 시작 시 Firebase에서 로드, 정지 시 Firebase에 클라우드 자동 저장 | Firebase Realtime DB(영구 보관) | ??내최고점수, ??골드, ??인벤토리 |
| ?! | 동기화 + 영구 저장(변수 및 리스트) | 플레이 중에는 실시간 동기화, 마지막 플레이어가 퇴장(인원 0명)할 때 Firebase에 최종 상태 백업 | WebSocket + Firebase(퇴장 시 안전 보관) | ?!공용창고, ?!월드블록상태 |
엔트리 블록 코딩 예시
1. 서버 연결 확인 후 작품 시작하기
[작품이 시작되었을 때]
[만약 <( [?!] ) = (1)> 라면]
[말하기: "멀티플레이 서버 연결 성공!"]
[신호 (작품시작) 보내기]
[아니라면]
[말하기: "오프라인 모드로 전환합니다."]
2. 실시간 멀티플레이어 좌표 이동 (!!)
[오른쪽 화살표 키를 눌렀을 때]
[(!!내플레이어X) 에 (10) 만큼 더하기]
// 같은 방의 모든 참가자 화면에 즉시 동기화됩니다!
3. 세이브 데이터 누적 (??)
[몬스터를 처치했을 때]
[(??보유골드) 에 (50) 만큼 더하기]
// 작품이 정지되거나 브라우저를 닫아도 클라우드에 자동 보관됩니다!
시스템 아키텍처 (Architecture)
Entry Sync는 글로벌 엣지 컴퓨팅 기반의 완전 무서버(Serverless) 분산 구조로 설계되어 트래픽 급증에도 안정적으로 동작합니다.
flowchart LR
subgraph Client ["Client (사용자 브라우저)"]
Entry["엔트리 플레이어\n(playentry.org)"]
Ext["Entry Sync\nChrome 확장프로그램"]
Entry <-->|"변수 상태 감지 & 주입"| Ext
end
subgraph Cloudflare ["Cloudflare Edge (글로벌 엣지 네트워크)"]
DO["Durable Objects (Room DO)\n• WebSocket 하이버네이션\n• 실시간 방 세션 관리\n• 인원 0명 시 메모리 정화"]
end
subgraph Google ["Google Cloud"]
FB[("Firebase Realtime Database\n• ?? 저장 전용 데이터\n• ?! 세션 퇴장 데이터 영구 보관")]
end
Ext <-->|"WebSocket (WSS / TLS 1.3)"| DO
DO <-->|"REST API (자동 플러시)"| FB
Ext -.->|"?? 로드/저장 직접 통신"| FB
style Client fill:#0d111b,stroke:#00d2ff,stroke-width:2px,color:#fff
style Cloudflare fill:#141226,stroke:#f38020,stroke-width:2px,color:#fff
style Google fill:#1c1713,stroke:#ffca28,stroke-width:2px,color:#fff
3분 퀵 스타트 (Quick Start)
1단계: 확장프로그램 설치
2단계: 엔트리에서 변수/리스트 생성
- 엔트리 작품 제작 화면에서 원하는 변수/리스트 앞에 기호를 붙입니다.
- 실시간 위치:
!!player_x, !!player_y
- 클라우드 저장:
??saved_coins
- 상태 감지:
?!
3단계: 시작 버튼 클릭
- 작품 시작 버튼을 누르면 상태 변수
?!가 1로 바뀌며 실시간 세션과 클라우드 저장이 자동으로 활성화됩니다!
📂 프로젝트 구조 (Repository Structure)
Entry Sync/
├── extension/ # Chrome 확장프로그램 소스코드
| ├── manifest.json # MV3 매니페스트 설정
| ├── content.js # 엔트리 웹페이지 삽입 및 통신 브릿지
| ├── inject.js # 엔트리 엔진(Page World) 내부 변수 후킹 및 상태 주입
| ├── popup.html # 팝업 대시보드 UI
| ├── popup.js # 팝업 상태 모니터링 로직
| └── icons/ # 공식 아이콘 애셋
|
├── README.md
|
└── 개인정보처리방침.md
보안 및 개인정보 보호 (Privacy & Security)
Entry Sync는 사용자의 신뢰와 보안을 가장 중요하게 생각합니다.
- 개인식별정보 0%: 이름, 이메일, 계정 비밀번호, 금융 정보, 브라우징 히스토리를 전혀 수집하지 않습니다.
- 암호화 통신: 모든 네트워크 통신은 최신 TLS 1.3 / HTTPS 및 보안 WebSocket(WSS) 프로토콜을 통과합니다.
- 투명한 정책: 자세한 내용은 개인정보처리방침.md 또는 온라인 개인정보처리방침에서 확인하실 수 있습니다.
🤝 기여 및 문의 (Contributing & Contact)
Entry Sync는 오픈소스 프로젝트이며 커뮤니티의 피드백과 기여를 언제나 환영합니다!
기여하기
버그 수정, 기능 개선, 문서 수정, 아이디어 제안 등 다양한 형태의 기여를 환영합니다.
기여하기 전에 아래 문서를 확인해주세요.
문의 및 피드백
Built with ❤️ for the Entry Creator Community
© 2026 Entry Sync Team. 본 프로젝트는 네이버 커넥트재단 엔트리(Entry)와 공식 제휴되지 않은 독립 오픈소스 소프트웨어입니다.
